Get a vacancy by VacancyId

GET 
/:customerId/vacancies/:vacancyId

Get a vacancy by VacancyId

Request

Path Parameters

customerId uuidrequired

A unique UUID value that identifies the customer.

vacancyId stringrequired

VacancyId of the Vacancy to get.

Query Parameters

IncludeAdvertisementText boolean
$preview int32

Header Parameters

X-MindKey-User-Language string

Default value: en-us

Specify User UI Language

X-MindKey-User-Culture string

Default value: en-us

Specify User UI Culture

X-MindKey-User-Timezone string

Default value: Europe/Copenhagen

Specify timezone.

Responses

200

OK

application/json

Schema

Schema

id stringnullable
description stringnullable

type

object

id stringnullable

description stringnullable
startDate date-timenullable
endDate date-timenullable
positionStartDate date-timenullable
priority int32
reAdvertisement boolean
unsolicited boolean
employmentCategoryName stringnullable
internalAccess boolean
externalAccess boolean
teaserText stringnullable
contactEmployeeName stringnullable
contactEmployeeWorkPhoneNumber stringnullable
contactEmployeWorkPhoneNumber stringnullabledeprecated
contactEmployeeMobilePhoneNumber stringnullable
contactEmployeeEmail stringnullable
organizationName stringnullable
companyName stringnullable
companyAddress stringnullable
candidateApplicationFormTypeId stringnullable
advertisementText stringnullable

locations

object[]

nullable

Array [

id stringnullable

description stringnullable

]

fieldsOfWork

object[]

nullable

Array [

id stringnullable

description stringnullable

]

regions

object[]

nullable

Array [

id stringnullable

description stringnullable

]

areas

object[]

nullable

Array [

id stringnullable

]

vacancyElements

object[]

nullable

Array [

id stringnullable

description stringnullable

allowMultipleSelection boolean

vacancyElementLines

object[]

nullable

Array [

id stringnullable

description stringnullable

]

]

medias

object[]

nullable

Array [

id stringnullable

description stringnullable

]

bannerImage stringnullable
bannerImageMimeType stringnullable
listImage stringnullable
listImageMimeType stringnullable

Example (from schema)

{
  "id": "string",
  "description": "string",
  "type": {
    "id": "string",
    "description": "string"
  },
  "startDate": "2026-03-25T15:10:38.547Z",
  "endDate": "2026-03-25T15:10:38.547Z",
  "positionStartDate": "2026-03-25T15:10:38.547Z",
  "priority": 0,
  "reAdvertisement": true,
  "unsolicited": true,
  "employmentCategoryName": "string",
  "internalAccess": true,
  "externalAccess": true,
  "teaserText": "string",
  "contactEmployeeName": "string",
  "contactEmployeeWorkPhoneNumber": "string",
  "contactEmployeeMobilePhoneNumber": "string",
  "contactEmployeeEmail": "string",
  "organizationName": "string",
  "companyName": "string",
  "companyAddress": "string",
  "candidateApplicationFormTypeId": "string",
  "advertisementText": "string",
  "locations": [
    {
      "id": "string",
      "description": "string"
    }
  ],
  "fieldsOfWork": [
    {
      "id": "string",
      "description": "string"
    }
  ],
  "regions": [
    {
      "id": "string",
      "description": "string"
    }
  ],
  "areas": [
    {
      "id": "string"
    }
  ],
  "vacancyElements": [
    {
      "id": "string",
      "description": "string",
      "allowMultipleSelection": true,
      "vacancyElementLines": [
        {
          "id": "string",
          "description": "string"
        }
      ]
    }
  ],
  "medias": [
    {
      "id": "string",
      "description": "string"
    }
  ],
  "bannerImage": "string",
  "bannerImageMimeType": "string",
  "listImage": "string",
  "listImageMimeType": "string"
}

400

Bad request provided

404

Not Found

500

Internal Server Error

Loading...