GET /Jobs/HotJobs

Service for getting a list of Hot Job ads.

Request Information

URI Parameters

None.

Body Parameters

None.

OData support

Optional query options:
- $top (default/max is 100)
- $skip
- $filter
- $select
- $orderby (fields supported: JobId, JobActivationDate)

Supported logical operators:
- and
- or
- eq
- gt
- ge
- lt
- le
- not
- ne

Supported functions:
- any
- substringof

Query examples

$top, $skip
/Jobs/?$top=10&$skip=0

$filter on JobCategory (Admin, Secretarial, PA)
/Jobs/?$top=10&$skip=0&$filter=JobCategories/any(c: c/Id eq 102)

$filter on JobType (Part-time)
/Jobs/?$top=10&$skip=0&$filter=JobTypes/any(t: t/Id eq 7)

$filter on JobLocation (Norfolk)
/Jobs/?$top=10&$skip=0&$filter=JobLocations/any(l: l/District2Code eq '98')

$filter on JobLocation (not in UK)
/Jobs/$filter=not JobLocations/any(l: l/CountryCode eq 'UK')

$filter on JobActivationDate (creation date after 1/5 2013)
/Jobs?$filter=JobActivationDate gt datetime'2013-05-01T00:00:00.0000000Z'

$orderby JobActivationDate (newest first)
/Jobs/?$top=10&$skip=0&$orderby=JobActivationDate desc

$filter on JobHeading or JobPresentationText or Company/CompanyName
/Jobs/?$top=10&$skip=0&$filter=substringof('nurse', JobHeading) or substringof('nurse', JobPresenatationText) or substringof('nurse', Company/CompanyName)

Response Information

Resource Description

Collection of Job
NameDescriptionTypeAdditional information
JobId

decimal number

None.

JobHeading

string

None.

JobPresenatationText

string

None.

JobActivationDate

date

None.

JobExpiryDate

date

None.

JobProductPackageId

integer

None.

JobApplyByPhone

boolean

None.

JobApplyByWalkin

boolean

None.

JobApplyByLetter

boolean

None.

JobApplyByEmail

boolean

None.

JobApplyByUrl

string

None.

JobApplyFirstname

string

None.

JobApplySurname

string

None.

JobApplyAddress1

string

None.

JobApplyAddress2

string

None.

JobApplyZipCode

string

None.

JobApplyTown

string

None.

JobApplyCountryId

string

None.

JobApplyPhone

string

None.

JobApplyFax

string

None.

JobApplyEmail

string

None.

JobInternalReference

string

None.

JobImportedReference

string

None.

JobExternalLink

string

None.

JobCategories

Collection of JobCategory

None.

JobTypes

Collection of JobType

None.

JobLocations

Collection of JobLocation

None.

JobReferences

JobReferences

None.

Company

Company

None.

ContactPerson

ContactPerson

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "JobId": 21647712.0,
    "JobHeading": "IT Support Technician",
    "JobPresenatationText": "If you are interested in computers and like solving problems, this could be the perfect job for you. IT support technicians help to find and correct software and hardware problems for computer users. To become an IT support technician, you will need to have a wide knowledge of operating systems. You’ll also need to know about networking, hardware and software. And you’ll be able to explain problems and solutions clearly to non-technical users. If you have a good working knowledge of computer systems, you could begin as a trainee technician. You may improve your career prospects by gaining IT qualifications.",
    "JobActivationDate": "2013-04-17T12:36:33.007",
    "JobExpiryDate": "2013-05-15T00:00:00",
    "JobProductPackageId": 368,
    "JobApplyByPhone": false,
    "JobApplyByWalkin": false,
    "JobApplyByLetter": false,
    "JobApplyByEmail": true,
    "JobApplyByUrl": null,
    "JobApplyFirstname": "John",
    "JobApplySurname": "Doe",
    "JobApplyAddress1": "The long street 88",
    "JobApplyAddress2": "",
    "JobApplyZipCode": "NR8 6FT",
    "JobApplyTown": "Norfolk",
    "JobApplyCountryId": "UK",
    "JobApplyPhone": "0047 542264658",
    "JobApplyFax": "568971264",
    "JobApplyEmail": "email@domian.com",
    "JobInternalReference": null,
    "JobImportedReference": null,
    "JobExternalLink": "http://www.domain.com/redirect.aspx?action=JobSearch,ViewJob&p=jobId%3D21647712",
    "JobCategories": [
      {
        "Id": 8,
        "Name": "Law and Legal Services"
      }
    ],
    "JobTypes": [
      {
        "Id": 8.0,
        "Name": "Full-time"
      },
      {
        "Id": 46.0,
        "Name": "Permanent"
      }
    ],
    "JobLocations": [
      {
        "ContinentCode": 2,
        "ContinentName": "Europe",
        "CountryCode": "UK",
        "CountryName": "United Kingdom",
        "District1Code": "128",
        "District1Name": "East",
        "District2Code": "98",
        "District2Name": "Norfolk",
        "District3Code": null,
        "District3Name": null,
        "District4Code": null,
        "District4Name": null
      }
    ],
    "JobReferences": {
      "R1": "Vestibulum ante Nunc convallis.",
      "R18": "Aliquam erat commodo odiof.",
      "R19": "Nunc convallis commodo odio.",
      "R20": "Ut luctus aliquam erat. Vestibulum ante.",
      "R22": null,
      "R23": null,
      "R24": null
    },
    "Company": {
      "CompanyId": 711396.0,
      "CompanyName": "IT Recruitment Solutions",
      "CompanyAddress1": "48 The Street",
      "CompanyAddress2": "Norwich",
      "CompanyZipCode": "NR8 6FT",
      "CompanyTown": "NORWICH",
      "CompanyCountryId": "UK",
      "CompanyPhone": "0971 984 6237",
      "CompanyFax": "01503 765562",
      "CompanyEmail": "email@domain.com",
      "CompanyWebpage": "http://www.domain.com",
      "CompanySmallLogoURL": "http://www.domain.com/shared/services/logos/711396_small.gif",
      "CompanyLargeLogoURL": "http://www.domain.com/shared/services/logos/711396_large.gif"
    },
    "ContactPerson": {
      "ContactPersonId": 323764687.0,
      "ContactPersonFirstname": "Abbey",
      "ContactPersonSurname": "Lawson",
      "ContactPersonAddress1": "48 The Street",
      "ContactPersonAddress2": "Norwich",
      "ContactPersonZipCode": "NR8 6FT",
      "ContactPersonTown": "NORWICH",
      "ContactPersonCountryId": "UK",
      "ContactPersonPhone": "0971 984 6237",
      "ContactPersonFax": "01503 765562",
      "ContactPersonEmail": "email@domain.com"
    }
  }
]

application/xml, text/xml

Sample:
<ArrayOfJob xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/MatchWork.API.Models">
  <Job>
    <Company>
      <CompanyAddress1>48 The Street</CompanyAddress1>
      <CompanyAddress2>Norwich</CompanyAddress2>
      <CompanyCountryId>UK</CompanyCountryId>
      <CompanyEmail>email@domain.com</CompanyEmail>
      <CompanyFax>01503 765562</CompanyFax>
      <CompanyId>711396</CompanyId>
      <CompanyLargeLogoURL>http://www.domain.com/shared/services/logos/711396_large.gif</CompanyLargeLogoURL>
      <CompanyName>IT Recruitment Solutions</CompanyName>
      <CompanyPhone>0971 984 6237</CompanyPhone>
      <CompanySmallLogoURL>http://www.domain.com/shared/services/logos/711396_small.gif</CompanySmallLogoURL>
      <CompanyTown>NORWICH</CompanyTown>
      <CompanyWebpage>http://www.domain.com</CompanyWebpage>
      <CompanyZipCode>NR8 6FT</CompanyZipCode>
    </Company>
    <ContactPerson>
      <ContactPersonAddress1>48 The Street</ContactPersonAddress1>
      <ContactPersonAddress2>Norwich</ContactPersonAddress2>
      <ContactPersonCountryId>UK</ContactPersonCountryId>
      <ContactPersonEmail>email@domain.com</ContactPersonEmail>
      <ContactPersonFax>01503 765562</ContactPersonFax>
      <ContactPersonFirstname>Abbey</ContactPersonFirstname>
      <ContactPersonId>323764687</ContactPersonId>
      <ContactPersonPhone>0971 984 6237</ContactPersonPhone>
      <ContactPersonSurname>Lawson</ContactPersonSurname>
      <ContactPersonTown>NORWICH</ContactPersonTown>
      <ContactPersonZipCode>NR8 6FT</ContactPersonZipCode>
    </ContactPerson>
    <JobActivationDate>2013-04-17T12:36:33.007</JobActivationDate>
    <JobApplyAddress1>The long street 88</JobApplyAddress1>
    <JobApplyAddress2></JobApplyAddress2>
    <JobApplyByEmail>true</JobApplyByEmail>
    <JobApplyByLetter>false</JobApplyByLetter>
    <JobApplyByPhone>false</JobApplyByPhone>
    <JobApplyByUrl i:nil="true" />
    <JobApplyByWalkin>false</JobApplyByWalkin>
    <JobApplyCountryId>UK</JobApplyCountryId>
    <JobApplyEmail>email@domian.com</JobApplyEmail>
    <JobApplyFax>568971264</JobApplyFax>
    <JobApplyFirstname>John</JobApplyFirstname>
    <JobApplyPhone>0047 542264658</JobApplyPhone>
    <JobApplySurname>Doe</JobApplySurname>
    <JobApplyTown>Norfolk</JobApplyTown>
    <JobApplyZipCode>NR8 6FT</JobApplyZipCode>
    <JobCategories>
      <JobCategory>
        <Id>8</Id>
        <Name>Law and Legal Services</Name>
      </JobCategory>
    </JobCategories>
    <JobExpiryDate>2013-05-15T00:00:00</JobExpiryDate>
    <JobExternalLink>http://www.domain.com/redirect.aspx?action=JobSearch,ViewJob&amp;p=jobId%3D21647712</JobExternalLink>
    <JobHeading>IT Support Technician</JobHeading>
    <JobId>21647712</JobId>
    <JobImportedReference i:nil="true" />
    <JobInternalReference i:nil="true" />
    <JobLocations>
      <JobLocation>
        <ContinentCode>2</ContinentCode>
        <ContinentName>Europe</ContinentName>
        <CountryCode>UK</CountryCode>
        <CountryName>United Kingdom</CountryName>
        <District1Code>128</District1Code>
        <District1Name>East</District1Name>
        <District2Code>98</District2Code>
        <District2Name>Norfolk</District2Name>
        <District3Code i:nil="true" />
        <District3Name i:nil="true" />
        <District4Code i:nil="true" />
        <District4Name i:nil="true" />
      </JobLocation>
    </JobLocations>
    <JobPresenatationText>If you are interested in computers and like solving problems, this could be the perfect job for you. IT support technicians help to find and correct software and hardware problems for computer users. To become an IT support technician, you will need to have a wide knowledge of operating systems. You’ll also need to know about networking, hardware and software. And you’ll be able to explain problems and solutions clearly to non-technical users. If you have a good working knowledge of computer systems, you could begin as a trainee technician. You may improve your career prospects by gaining IT qualifications.</JobPresenatationText>
    <JobProductPackageId>368</JobProductPackageId>
    <JobReferences>
      <R1>Vestibulum ante Nunc convallis.</R1>
      <R18>Aliquam erat commodo odiof.</R18>
      <R19>Nunc convallis commodo odio.</R19>
      <R20>Ut luctus aliquam erat. Vestibulum ante.</R20>
      <R22 i:nil="true" />
      <R23 i:nil="true" />
      <R24 i:nil="true" />
    </JobReferences>
    <JobTypes>
      <JobType>
        <Id>8</Id>
        <Name>Full-time</Name>
      </JobType>
      <JobType>
        <Id>46</Id>
        <Name>Permanent</Name>
      </JobType>
    </JobTypes>
  </Job>
</ArrayOfJob>