---
title: "Get job board postings for vacancy"
method: GET
path: "/job-boards/{vacancyId}"
tags: ["Job Boards"]
---

# Get job board postings for vacancy

`GET /job-boards/{vacancyId}`

Get job board postings for a vacancy in the API key tenant.

## Path parameters

- `vacancyId` string, required

## Query parameters

- `limit` integer
- `cursor` string
- `jobBoardProvider` 'LINKEDIN' | 'SPOTT' | 'BROADBEAN' | 'IDIBU' | 'VDAB_VACATURE'

## Response `200`

Job board postings returned successfully.

- JobBoardPostingsDto
  - `jobBoardPostings` JobBoardPostingDto[], required
    - `id` string, required
    - `jobBoardProvider` 'LINKEDIN' | 'SPOTT' | 'BROADBEAN' | 'IDIBU' | 'VDAB_VACATURE', required
    - `status` 'PUBLISHED' | 'CLOSED' | 'DRAFT', required
    - `publishedAt` string, date-time, required
    - `unpublishedAt` string, date-time, required
    - `closedAt` string, date-time, required
    - `applyUrl` string, nullable, required
    - `targetStageId` string, nullable, required
    - `linkedInProjectUrl` string, nullable, required
    - `responseCount` number, nullable, required
    - `channel` string, nullable, required
  - `pagination` object, required
    - `cursor` string, nullable, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - invalid or missing API key
- `500` — Error response

---

[API](https://skmtc.net/spott/apis/spott-webhooks.md) · [All operations](https://skmtc.net/spott/apis/spott-webhooks/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spott/spott-webhooks/versions/ad1f8c51cf0a/schema)