> 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/ophalen.md).

# Ophalen

Alle vacatures, één vacature of een selectie ophalen.

Je kunt alle vacatures ophalen, één vacature op kenmerk, of een aantal vacatures tegelijk.

* **Vereist recht:** Alle vacatures inzien

## Alle vacatures

* **Aanroep:** `GET /recruiter/vacancies`
* **Verplicht:** niets
* **Optioneel:** niets

Het antwoord bevat alle vacatures van de omgeving. Daar horen ook vervulde vacatures bij (`isCompleted` is `true`) en vacatures waarvan de sluitingsdatum voorbij is.

```bash
curl "https://mijn.cootje.com/api/recruiter/vacancies" \
  -H "Authorization: Bearer JOUW_TOKEN"
```

## Eén vacature

* **Aanroep:** `GET /recruiter/vacancies/{id}`
* **Verplicht:** `id` in de URL, het `_id` van de vacature
* **Optioneel:** niets

Bestaat de vacature niet, dan is het antwoord `404`.

## Meerdere vacatures tegelijk

* **Aanroep:** `POST /recruiter/vacancies/subset`
* **Verplicht:** een lijst met `_id`'s als inhoud van het verzoek
* **Optioneel:** niets

Kenmerken die niet bestaan, ontbreken in het antwoord.

```bash
curl -X POST "https://mijn.cootje.com/api/recruiter/vacancies/subset" \
  -H "Authorization: Bearer JOUW_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
    "VACATURE_ID_1",
    "VACATURE_ID_2"
  ]'
```

## Wat je terugkrijgt

Eén vacature ziet er zo uit:

```json
{
  "_id": "c3d4e5f6-1a2b-4c3d-8e9f-0a1b2c3d4e5f",
  "createdAt": "2027-01-12T09:30:00",
  "companyId": "0b7c2f6e-3d1a-4f5b-9a8e-1c2d3e4f5a6b",
  "company": "Voorbeeld Zorg B.V.",
  "title": "Projectleider zorg",
  "description": "Leiding geven aan de invoering van een nieuw roostersysteem.",
  "expectedOutcome": "Het nieuwe roostersysteem is op alle afdelingen in gebruik.",
  "assignmentRequirements": "Minimaal 5 jaar ervaring als projectleider in de zorg.",
  "assignmentRequirementsKnockOut": true,
  "preferredRequirements": "Ervaring met roostersystemen.",
  "competencies": "Communicatief sterk, resultaatgericht.",
  "location": "Utrecht",
  "minimumYrsExperience": 5,
  "closureDateTime": "2027-02-01T17:00:00",
  "internalClosureDateTime": "2027-02-02T17:00:00",
  "startDate": "2027-03-01T00:00:00",
  "reference": "INK-2027-014",
  "endDate": "2027-08-31T00:00:00",
  "hoursPerWeek": 32,
  "hourPrice": 85,
  "salesHourPrice": 95,
  "allowedContractForms": [
    1,
    3,
    4
  ],
  "extensionPossible": true,
  "recruiterId": "",
  "isCompleted": false,
  "notificationsEnabled": true
}
```

De aanroepen voor alle vacatures en voor meerdere vacatures geven een lijst van deze objecten, tussen `[` en `]`.

* Datums zijn tekst in de vorm `2027-03-01T00:00:00`.
* `allowedContractForms` bevat getallen: `1` zzp, `3` loondienst, `4` tijdelijke arbeidsovereenkomst.
* `company` is de naam van de klant, afgeleid van `companyId`.
* `recruiterId` is leeg als er geen recruiter is toegewezen.
* Of de vacature gepubliceerd is, staat niet in dit antwoord. Dat vraag je apart op, zie [Publiceren en depubliceren](https://docs.cootje.com/cootje-api/recruitment/vacatures/publiceren.md).

## Antwoorden

| Code  | Betekenis                                          |
| ----- | -------------------------------------------------- |
| `200` | De vacature of de lijst met vacatures              |
| `401` | Geen geldig token, of het account mist het recht   |
| `404` | De vacature bestaat niet (alleen bij één vacature) |
