WTTA-Dossier API

GET /api/v1/workers

Arbeidskrachten ophalen

Geeft een gepagineerde lijst, inclusief de dossiervolledigheid (completeness, 0 tot 100) per arbeidskracht.

Queryparameters

Voorbeeld

curl "https://wtta-dossier.nl/api/v1/workers?nationality=eu&limit=25" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{
  "workers": [
    {
      "id": "01JZX…",
      "first_name": "Jan",
      "last_name": "Kowalski",
      "nationality_category": "eu",
      "employment_start": "2026-03-01",
      "employment_end": null,
      "contract_type": "uitzendovereenkomst",
      "housing_provided": true,
      "email": "jan@example.com",
      "completeness": 80,
      "created_at": "2026-03-01T09:12:00.000Z"
    }
  ],
  "total": 1
}

GET /api/v1/workers/{id}

Arbeidskracht ophalen

Geeft het volledige dossier: de arbeidskracht, de dossierchecklist, gekoppelde documenten en plaatsingen.

Voorbeeld

curl "https://wtta-dossier.nl/api/v1/workers/01JZX…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{
  "worker": { "id": "01JZX…", "first_name": "Jan", … },
  "checklist": {
    "completeness": 80,
    "items": [ { "type": "id_bewijs", "present": true, … } ]
  },
  "documents": [ … ],
  "placements": [ … ]
}

POST /api/v1/workers

Arbeidskracht aanmaken

Maakt een arbeidskracht aan en genereert automatisch de bijbehorende dossiertaken.

Body

Voorbeeld

curl -X POST "https://wtta-dossier.nl/api/v1/workers" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "firstName": "Jan",
    "lastName": "Kowalski",
    "nationalityCategory": "eu",
    "employmentStart": "2026-03-01",
    "housingProvided": true
  }'

Respons

201 Created
{ "worker": { "id": "01JZX…", "first_name": "Jan", … } }

PATCH /api/v1/workers/{id}

Arbeidskracht bijwerken

Werkt alleen de meegestuurde velden bij. Alle velden van het aanmaak-verzoek zijn toegestaan.

Voorbeeld

curl -X PATCH "https://wtta-dossier.nl/api/v1/workers/01JZX…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{ "contractType": "detachering" }'

Respons

{ "worker": { "id": "01JZX…", "contract_type": "detachering", … } }

DELETE /api/v1/workers/{id}

Arbeidskracht archiveren

Soft delete: het dossier blijft bewaard maar verdwijnt uit alle lijsten.

Voorbeeld

curl -X DELETE "https://wtta-dossier.nl/api/v1/workers/01JZX…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{ "ok": true }

GET /api/v1/documents

Documenten ophalen

Queryparameters

Voorbeeld

curl "https://wtta-dossier.nl/api/v1/documents?type=id_bewijs" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{
  "documents": [
    {
      "id": "01JZY…",
      "type": "id_bewijs",
      "title": "Paspoort Jan Kowalski",
      "file_name": "paspoort.pdf",
      "mime_type": "application/pdf",
      "size_bytes": 182044,
      "expiry_date": "2030-05-01",
      "worker_id": "01JZX…",
      "worker_name": "Jan Kowalski",
      "created_at": "2026-03-02T10:00:00.000Z"
    }
  ],
  "total": 1
}

GET /api/v1/documents/{id}

Document ophalen

Voorbeeld

curl "https://wtta-dossier.nl/api/v1/documents/01JZY…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{ "document": { "id": "01JZY…", "type": "id_bewijs", … } }

POST /api/v1/documents

Document uploaden

Upload als multipart/form-data met een verplicht file-veld. De respons bevat completedTasks: taken die door deze upload automatisch zijn afgerond.

Body

Voorbeeld

curl -X POST "https://wtta-dossier.nl/api/v1/documents" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -F "file=@paspoort.pdf" \
  -F "type=id_bewijs" \
  -F "title=Paspoort Jan Kowalski" \
  -F "workerId=01JZX…"

Respons

201 Created
{
  "document": { "id": "01JZY…", "type": "id_bewijs", … },
  "completedTasks": [ { "id": "01JZZ…", "title": "ID-check uitvoeren: Jan Kowalski", … } ]
}

PATCH /api/v1/documents/{id}

Documentmetadata bijwerken

Werkt metadata bij (JSON, geen bestand). Dezelfde velden als bij de upload, behalve file.

Voorbeeld

curl -X PATCH "https://wtta-dossier.nl/api/v1/documents/01JZY…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{ "expiryDate": "2031-01-01" }'

Respons

{ "document": { … }, "completedTasks": [] }

GET /api/v1/documents/{id}/download

Downloadlink opvragen

Geeft een tijdelijke, ondertekende downloadlink naar het bestand. De link verloopt na korte tijd; vraag per download een nieuwe op.

Voorbeeld

curl "https://wtta-dossier.nl/api/v1/documents/01JZY…/download" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{ "url": "https://…/paspoort.pdf?X-Amz-Signature=…" }

DELETE /api/v1/documents/{id}

Document archiveren

Soft delete: het bestand blijft in de kluis vanwege de wettelijke bewaartermijn.

Voorbeeld

curl -X DELETE "https://wtta-dossier.nl/api/v1/documents/01JZY…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{ "ok": true }

GET /api/v1/clients

Inleners ophalen

Queryparameters

Voorbeeld

curl "https://wtta-dossier.nl/api/v1/clients" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{
  "clients": [
    {
      "id": "01JZA…",
      "name": "Bouwbedrijf Jansen BV",
      "kvk_number": "12345678",
      "contact_name": "P. Jansen",
      "contact_email": "p.jansen@example.com",
      "created_at": "2026-02-01T08:00:00.000Z"
    }
  ],
  "total": 1
}

GET /api/v1/clients/{id}

Inlener ophalen

Inclusief alle plaatsingen bij deze inlener.

Voorbeeld

curl "https://wtta-dossier.nl/api/v1/clients/01JZA…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{ "client": { … }, "placements": [ { "id": "01JZB…", "worker_name": "Jan Kowalski", … } ] }

POST /api/v1/clients

Inlener aanmaken

Body

Voorbeeld

curl -X POST "https://wtta-dossier.nl/api/v1/clients" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Bouwbedrijf Jansen BV", "kvkNumber": "12345678" }'

Respons

201 Created
{ "client": { "id": "01JZA…", "name": "Bouwbedrijf Jansen BV", … } }

PATCH /api/v1/clients/{id}

Inlener bijwerken

Voorbeeld

curl -X PATCH "https://wtta-dossier.nl/api/v1/clients/01JZA…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{ "contactName": "M. de Vries" }'

Respons

{ "client": { … } }

DELETE /api/v1/clients/{id}

Inlener archiveren

Voorbeeld

curl -X DELETE "https://wtta-dossier.nl/api/v1/clients/01JZA…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{ "ok": true }

GET /api/v1/placements

Plaatsingen ophalen

Queryparameters

Voorbeeld

curl "https://wtta-dossier.nl/api/v1/placements?workerId=01JZX…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{
  "placements": [
    {
      "id": "01JZB…",
      "client_id": "01JZA…",
      "worker_id": "01JZX…",
      "client_name": "Bouwbedrijf Jansen BV",
      "worker_name": "Jan Kowalski",
      "location": "Utrecht",
      "start_date": "2026-03-01",
      "end_date": null
    }
  ],
  "total": 1
}

POST /api/v1/placements

Plaatsing registreren

Body

Voorbeeld

curl -X POST "https://wtta-dossier.nl/api/v1/placements" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "01JZA…",
    "workerId": "01JZX…",
    "startDate": "2026-03-01",
    "location": "Utrecht"
  }'

Respons

201 Created
{ "placement": { "id": "01JZB…", … } }

PATCH /api/v1/placements/{id}

Plaatsing bijwerken

Alleen location, startDate en endDate kunnen worden gewijzigd.

Voorbeeld

curl -X PATCH "https://wtta-dossier.nl/api/v1/placements/01JZB…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{ "endDate": "2026-09-30" }'

Respons

{ "placement": { … } }

GET /api/v1/tasks

Taken ophalen

Queryparameters

Voorbeeld

curl "https://wtta-dossier.nl/api/v1/tasks?status=open" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{
  "tasks": [
    {
      "id": "01JZZ…",
      "title": "VOG aanvragen",
      "status": "open",
      "source": "handmatig",
      "due_date": "2026-08-01",
      "assignee_user_id": "abc…",
      "assignee_name": "A. de Boer",
      "worker_id": null,
      "recurrence": "none",
      "completed_at": null
    }
  ],
  "total": 1
}

GET /api/v1/tasks/{id}

Taak ophalen

Voorbeeld

curl "https://wtta-dossier.nl/api/v1/tasks/01JZZ…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

Respons

{ "task": { "id": "01JZZ…", "title": "VOG aanvragen", … } }

POST /api/v1/tasks

Taak aanmaken

Body

Voorbeeld

curl -X POST "https://wtta-dossier.nl/api/v1/tasks" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{ "title": "VOG aanvragen", "dueDate": "2026-08-01" }'

Respons

201 Created
{ "task": { "id": "01JZZ…", "status": "open", "source": "handmatig", … } }

PATCH /api/v1/tasks/{id}

Taak bijwerken of afronden

Zet status op afgerond om een taak af te ronden (completed_at wordt gevuld) of terug op open om te heropenen. Andere velden zoals title, dueDate en assigneeUserId kunnen tegelijk worden bijgewerkt.

Voorbeeld

curl -X PATCH "https://wtta-dossier.nl/api/v1/tasks/01JZZ…" \
  -H "Authorization: Bearer nd_live_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{ "status": "afgerond" }'

Respons

{ "task": { "status": "afgerond", "completed_at": "2026-07-16T14:03:00.000Z", … } }