KLICBOT API – Getting Started

Authenticatie

Elke v1-request vereist een API-key in de header. Aanmaken onder Instellingen, bij API en integraties, na inloggen met werkmail (inloggen). KLICBOT API heeft gratis toegang. Geen abonnement. Je betaalt €39,95 per KLIC-melding.

X-API-Key: uw_api_key_hier

Keys worden server-side gehashed opgeslagen. KLICBOT API is REST voor GIS. MCP op /mcp is optioneel voor AI-clients. Zie MCP Server.

Voorbeeld: aanvragen ophalen

curl -s "https://klicbot.nl/api/v1/requests?page=1&page_size=20" \
  -H "X-API-Key: YOUR_API_KEY"

Response (vereenvoudigd):

{
  "data": [ /* aanvragen */ ],
  "pagination": {
    "page": 1,
    "page_size": 20,
    "total": 42,
    "total_pages": 3
  }
}

Voorbeeld: detail van één aanvraag

curl -s "https://klicbot.nl/api/v1/request/ORDER_ID" \
  -H "X-API-Key: YOUR_API_KEY"

Voorbeeld: oriëntatie quoten (geen Kadaster-POST)

curl -s "https://klicbot.nl/api/v1/jobs" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"klic_type":"ORIENT","reference":"pilot-bunnik","geometry":{"type":"Polygon","coordinates":[[[5.19,52.06],[5.21,52.06],[5.21,52.08],[5.19,52.08],[5.19,52.06]]]}}'

submit: true dient in (write-key + factuur/eigen Kadaster) en geeft HTTP 202. Daarna GET /api/v1/jobs/{job_id} of webhook job.ready. Zelfde client_ref hergebruikt de job. GRAAF vereist start_date. Optioneel address (BAG-adres in de polygoon) voorkomt “geen huisnummer in weiland”.

Volgende stappen

• Core Concepts
• Endpoints
• Webhooks
• MCP Server

Vragen over volume of SLA: contact@klicbot.nl.