> For the complete documentation index, see [llms.txt](https://docs.cootje.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cootje.com/cootje-api/recruitment/vacatures.md).

# Vacatures

Vacatures ophalen, aanmaken, bijwerken en verwijderen via de Cootje API.

Een vacature is een opdracht van een klant waarvoor je kandidaten zoekt. Via de API kun je vacatures ophalen, aanmaken, bijwerken, verwijderen en publiceren. Met de iFrame toon je de gepubliceerde vacatures op je eigen website.

## In dit onderdeel

| Pagina                                                                                               | Aanroep                                  | Vereist recht             |
| ---------------------------------------------------------------------------------------------------- | ---------------------------------------- | ------------------------- |
| [Ophalen](https://docs.cootje.com/cootje-api/recruitment/vacatures/ophalen.md)                       | `GET /recruiter/vacancies`               | Alle vacatures inzien     |
| [Aanmaken](https://docs.cootje.com/cootje-api/recruitment/vacatures/aanmaken.md)                     | `POST /recruiter/vacancies`              | Alle vacatures bewerken   |
| [Bijwerken](https://docs.cootje.com/cootje-api/recruitment/vacatures/bijwerken.md)                   | `PUT /recruiter/vacancies/{id}`          | Alle vacatures bewerken   |
| [Verwijderen](https://docs.cootje.com/cootje-api/recruitment/vacatures/verwijderen.md)               | `DELETE /recruiter/vacancies/{id}`       | Alle vacatures bewerken   |
| [Publiceren en depubliceren](https://docs.cootje.com/cootje-api/recruitment/vacatures/publiceren.md) | `POST /recruiter/vacancies/{id}/publish` | Alle vacatures publiceren |
| [iFrame](https://docs.cootje.com/cootje-api/recruitment/vacatures/iframe.md)                         | geen: een regel HTML voor je website     | geen                      |

## Goed om te weten

* Datums zijn tekst in de vorm `2027-03-01T00:00:00`.
* Een nieuwe vacature is nog niet gepubliceerd. Pas na [publiceren](https://docs.cootje.com/cootje-api/recruitment/vacatures/publiceren.md) is hij zichtbaar op de openbare vacaturepagina en in de [iFrame](https://docs.cootje.com/cootje-api/recruitment/vacatures/iframe.md).
* Of een vacature gepubliceerd is, staat niet op de vacature zelf. Dat vraag je apart op, zie [Publiceren en depubliceren](https://docs.cootje.com/cootje-api/recruitment/vacatures/publiceren.md).
