GET api/v1/portals/{portalUid}/jobs/featured?count={count}&divisions={divisions}&classifications={classifications}&notSetValue={notSetValue}

Gets the featured jobs using the parameters provided.

Request Information

URI Parameters

NameDescriptionTypeAdditional information
portalUid

The portal UID.

globally unique identifier

Required

count

The numbers of records to be returned.

integer

Default value is 1000

divisions

The divisions used to describe this vacancy.

string

Default value is

classifications

The classifications used to describe this vacancy.

string

Default value is

notSetValue

The value used to describe returned NULL values.

string

Default value is -NOT SET-

Body Parameters

None.

Response Information

Resource Description

Returns the featured job results.

Collection of JobSearchViewModel
NameDescriptionTypeAdditional information
Uid

The job UID

globally unique identifier

None.

Industry

The industry used to describe the vacancy.

string

None.

Discipline

The discipline used to describe the vacancy.

string

None.

SubDiscipline

The sub discipline used to describe the vacancy.

string

None.

Country

The country in which the vacancy is located.

string

None.

Region

The general regions in which the vacancy is located.

string

None.

Location

The specific location in which the vacancy is located.

string

None.

StartDate

The start date of the vacancy.

date

None.

EndDate

The end date of the vacancy.

date

None.

Duration

The duration of the vacancy.

string

None.

Division

The divisions used to describe the vacancy.

string

None.

Classification

The classifications used to describe the vacancy.

string

None.

JobType

The job type of vacancy.

string

None.

ClientName

The name of the client.

string

None.

DatePosted

The date the vacancy was posted.

date

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "Uid": "8bb3998a-c2d8-45c5-86b4-bc3cde5b6d93",
    "Industry": "sample string 2",
    "Discipline": "sample string 3",
    "SubDiscipline": "sample string 4",
    "Country": "sample string 5",
    "Region": "sample string 6",
    "Location": "sample string 7",
    "StartDate": "2025-10-27T13:58:49.2688014+00:00",
    "EndDate": "2025-10-27T13:58:49.2688014+00:00",
    "Duration": "sample string 10",
    "Division": "sample string 11",
    "Classification": "sample string 12",
    "JobType": "sample string 13",
    "ClientName": "sample string 14",
    "DatePosted": "2025-10-27T13:58:49.2688014+00:00"
  },
  {
    "Uid": "8bb3998a-c2d8-45c5-86b4-bc3cde5b6d93",
    "Industry": "sample string 2",
    "Discipline": "sample string 3",
    "SubDiscipline": "sample string 4",
    "Country": "sample string 5",
    "Region": "sample string 6",
    "Location": "sample string 7",
    "StartDate": "2025-10-27T13:58:49.2688014+00:00",
    "EndDate": "2025-10-27T13:58:49.2688014+00:00",
    "Duration": "sample string 10",
    "Division": "sample string 11",
    "Classification": "sample string 12",
    "JobType": "sample string 13",
    "ClientName": "sample string 14",
    "DatePosted": "2025-10-27T13:58:49.2688014+00:00"
  }
]

application/xml, text/xml

Sample:
<ArrayOfJobSearchViewModel xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Eclipse.WebApi.Common.ViewModels">
  <JobSearchViewModel>
    <Classification>sample string 12</Classification>
    <ClientName>sample string 14</ClientName>
    <Country>sample string 5</Country>
    <DatePosted>2025-10-27T13:58:49.2688014+00:00</DatePosted>
    <Discipline>sample string 3</Discipline>
    <Division>sample string 11</Division>
    <Duration>sample string 10</Duration>
    <EndDate>2025-10-27T13:58:49.2688014+00:00</EndDate>
    <Industry>sample string 2</Industry>
    <JobType>sample string 13</JobType>
    <Location>sample string 7</Location>
    <Region>sample string 6</Region>
    <StartDate>2025-10-27T13:58:49.2688014+00:00</StartDate>
    <SubDiscipline>sample string 4</SubDiscipline>
    <Uid>8bb3998a-c2d8-45c5-86b4-bc3cde5b6d93</Uid>
  </JobSearchViewModel>
  <JobSearchViewModel>
    <Classification>sample string 12</Classification>
    <ClientName>sample string 14</ClientName>
    <Country>sample string 5</Country>
    <DatePosted>2025-10-27T13:58:49.2688014+00:00</DatePosted>
    <Discipline>sample string 3</Discipline>
    <Division>sample string 11</Division>
    <Duration>sample string 10</Duration>
    <EndDate>2025-10-27T13:58:49.2688014+00:00</EndDate>
    <Industry>sample string 2</Industry>
    <JobType>sample string 13</JobType>
    <Location>sample string 7</Location>
    <Region>sample string 6</Region>
    <StartDate>2025-10-27T13:58:49.2688014+00:00</StartDate>
    <SubDiscipline>sample string 4</SubDiscipline>
    <Uid>8bb3998a-c2d8-45c5-86b4-bc3cde5b6d93</Uid>
  </JobSearchViewModel>
</ArrayOfJobSearchViewModel>