Get a detailed list of vacancies

GET 
/:customerId/vacancies/detailed

Get a detailed list of vacancies

Request

Path Parameters

customerId uuidrequired

A unique UUID value that identifies the customer.

Query Parameters

VacancyTypeId string
LocationId string
RegionName string
VacancyAreaName string
MediaId string

Filter by media id.

ExternalAccess boolean

ExternalAccess will be removed in an upcoming release.

InternalAccess boolean

InternalAccess will be removed in an upcoming release.

Access EnumAccess

Possible values: [External, Internal, All]

IncludeAdvertisementText boolean
PerDate date-time
SortDescending boolean
Unsolicited EnumVacancyListUnsolicited

Possible values: [Bottom, Top, Hide, Only]

SortField EnumVacancyListSortField

Possible values: [Description, StartDate, EndDate, Priority]

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

• Array [

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.543Z",
    "endDate": "2026-03-25T15:10:38.543Z",
    "positionStartDate": "2026-03-25T15:10:38.543Z",
    "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...