API docs by Redocly

TuesdayTalent API (1.4.0)

Download OpenAPI specification:Download

Tuesday Multimedia: info@tuesday.nl URL: https://www.tuesday.nl

Met de TuesdayTalent-API kunnen organisaties vacatures beheren en vacature-alerts inschieten in de TuesdayTalent-applicatie.

Dit is versie 1.4.0 van de TuesdayTalent API.
Versie 1.1.1 (7 dec 2023): Functiecategorieënlijst in de taxonomies-endpoint verbeterd. De isonline-endpoint toegevoegd.
Versie 1.2.0 (2 jul 2024): Verbetering van de afhandeling van requests en error-monitoring.
Versie 1.3.0 (13 aug 2024): Jobalert-endpoint toegevoegd.
Versie 1.4.0 (1 sep 2025): Job-entiteit uitgebreid met nieuwe velden en Jobchain hernoemd naar TuesdayTalent.

Rate-limit
Er geldt een rate-limit van 1000 requests per minuut voor het gebruik van deze API.

Autorisatie
Alleen geautoriseerde organisaties kunnen deze API gebruiken. Autorisatie vindt plaats d.m.v. 'Bearer Authentication'. Je hebt hiervoor een token nodig. Testen kan met de test-token. Met het productie-token kun je vacatures in TuesdayTalent direct activeren. Beide tokens vind je in het tabblad Organisatie in TuesdayTalent, zodra de API voor de organisatie is geactiveerd. Ben je ontwikkelaar en heb je geen token, neem dan contact op met de contactpersoon van de organisatie waarvoor de koppeling met de TuesdayTalent-API ontwikkeld gaat worden, of neem contact op met Tuesday.

Vacatures
Gebruik de taxonomies-methode voor koppeling van een vacature met: contracttypes (contractTypes), opleidingsniveaus (educationLevels), uren-per-week (hoursPerWeek), functiecategorieën (functionCategories), werkvelden (workFields), soort_vacature (jobTypes) en beschikbaarheid (availability). Gebruik de locations-methode voor het koppelen van een vacature aan een locatie. Let op: locaties worden in de TuesdayTalent-applicatie beheerd door de organisatie. Mutatie van locatiegegevens is de verantwoordelijkheid van de organisatie. Stem als nodig af met de contactpersoon van de organisatie.

Als je de test-token gebruikt dan worden de vacatures ingeschoten in de TuesdayTalent (werkgevers)omgeving, met de status test. Deze worden niet getoond in de website van de werkgeversorganisatie en zijn alleen te zien door in te loggen op de werkgeversorganisatie TuesdayTalent portal en de vacatures te filteren op status 'Test (API)'.

Vacature-alerts
Gebruik de taxonomies-methode voor koppeling van een vacature-alert met de van toepassing zijnde taxonomiëen.

jobs

Get a list of jobs

Retrieves a paged list of jobs.
To use the parameters, use ?pageNr=1&perPage=50&vacancyStatus=2&dateStart=2025-08-01&dateEnd=2025-09-01

Authorizations:
bearerAuth
query Parameters
pageNr
integer (pageNr) >= 1
Example: pageNr=1

The page number to retrieve. If a number less than 1 is provided, it will be capped at 1.

perPage
integer (perPage) [ 1 .. 50 ]
Default: 50
Example: perPage=50

The number of records per page. If a number higher than 50 is provided, it will be capped at 50.

vacancyStatus
integer (vacancyStatus) [ 1 .. 5 ]
Default: 2
Example: vacancyStatus=2

The status of the vacancy. By default the open vacancies are returned. If you need to get all items available, use -1 as value.
Use the taxonomies endpoint to get the available statuses.

dateStart
date <date> (dateStart)
Example: dateStart=2025-08-01

The start addDate to filter the jobs (format yyyy-mm-dd).

dateEnd
date <date> (dateEnd)
Example: dateEnd=2025-09-01

The end addDate to filter the jobs (format yyyy-mm-dd).

Responses

Response samples

Content type
application/json
{
  • "data": [
    ],
  • "meta": {
    }
}

taxonomies

Get a list of all taxonomies

Retrieves a list taxonomies with valid id's and their names.

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
{
  • "contractTypes": [
    ],
  • "educationLevel": [
    ],
  • "functionCategories": [
    ],
  • "workfield": [
    ],
  • "jobTypes": [
    ],
  • "availability": [
    ],
  • "vacancyStatus": [
    ]
}

isOnline

Check the status of the connection

Retrieves information over the tried connection

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
{
  • "message": "Test message",
  • "success": false,
  • "appName": "Application Name",
  • "version": "1.1.1"
}

custom-fields

Get a list of all custom fields of your organisation

Retrieves a list custom fields with valid id's and their names.

Authorizations:
bearerAuth

Responses

Response samples

Content type
application/json
{
  • "vacancyCustomField01": [
    ]
}

jobalerts

Post a new job alert

Creates a new job alert that is linked to the organisation.

Authorizations:
bearerAuth
Request Body schema: application/json; charset=UTF-8
required

JSON job alert object

email
required
string <= 128 characters

The email of the job alert recipient

frequentie
required
string <= 128 characters

One of daily, weekly or monthly

name
string

The name of the job alert recipient

privacy-agreement
required
boolean

This should be given as a boolean true, it's the responsibility of the user of the API to get this variable from the subscriber.

workfield
Array of integers non-empty [ items >= 1 ]

An array of id's for the workfields (this can be found in taxonomies endpoint)

educationLevel
Array of integers non-empty [ items >= 1 ]

An array of id's for the education level (this can be found in taxonomies endpoint)

functionCategory
Array of integers non-empty [ items >= 1 ]

An array of id's for the function category (this can be found in taxonomies endpoint)

vacancyCustomField01
Array of integers non-empty [ items >= 1 ]

An array of id's for the vacancy custom field 01 (this can be found in custom-fields endpoint)

zipcode
string <= 7 characters

The zipcode part of job alert filter

city
string <= 128 characters

The city part of job alert filter (wont work if zipcode is also present)

distance
integer <= 7 characters

A valid value for distance 5, 10, 25, 50, 100

Responses

Request samples

Content type
application/json; charset=UTF-8
{
  • "email": "string",
  • "frequentie": "string",
  • "name": "example@gmail.com",
  • "privacy-agreement": true,
  • "workfield": [
    ],
  • "educationLevel": [
    ],
  • "functionCategory": [
    ],
  • "vacancyCustomField01": [
    ],
  • "zipcode": "string",
  • "city": "string",
  • "distance": 0
}

Response samples

Content type
application/json
{
  • "message": "Job alert added successfully",
  • "id": 1,
  • "success": true
}