API-documentatie

Alles wat je nodig hebt om te koppelen. Machine-leesbare spec: OpenAPI 3.0 (JSON)

Authenticatie

Elke request stuurt je API-key mee als Bearer-token. Keys worden per organisatie uitgegeven en zijn per direct intrekbaar. Base-URL: https://registrobonaire.com

Authorization: Bearer rb_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

1. Voertuigstatus opvragen

GET /api/partner/v1/vehicle?q=… · scope vehicle.read — zoek op kenteken (BES-formaat) of VIN. Geen persoonsgegevens in het antwoord.

curl -H "Authorization: Bearer rb_live_…" \
  "https://registrobonaire.com/api/partner/v1/vehicle?q=B-1234"

{
  "found": true,
  "vehicle": {
    "vin": "JTDBT923771012345",
    "plate": "B-1234",
    "vehicle_type": "auto",
    "brand": "Toyota",
    "model": "Corolla",
    "color": "wit",
    "year": 2019,
    "status": "active",
    "registration_verified": true,
    "registered_since": "2026-05-14T12:00:00Z"
  },
  "theft": { "active": false },
  "open_transfer": false,
  "transfers_completed": 1
}

2. Eigendom verifiëren

POST /api/partner/v1/verify-ownership · scope ownership.verify — lever een naam en/of CRIB-nummer aan; het antwoord is uitsluitend match/no_match per veld. De geregistreerde gegevens zelf worden nooit teruggegeven.

curl -X POST -H "Authorization: Bearer rb_live_…" \
  -H "Content-Type: application/json" \
  -d '{"plate": "B-1234", "owner_name": "R. Martis"}' \
  https://registrobonaire.com/api/partner/v1/verify-ownership

{
  "vehicle_found": true,
  "registration_verified": true,
  "vehicle_status": "active",
  "match": true,
  "fields": { "owner_name": "match", "crib_number": "not_provided" }
}

3. Actuele diefstal-lijst

GET /api/partner/v1/theft/active · scope theft.read — alle voertuigen die nu als gestolen gemeld staan (max 500, nieuwste eerst). KPCN-aangiftenummer alleen voor opsporingsdiensten en overheid.

curl -H "Authorization: Bearer rb_live_…" \
  https://registrobonaire.com/api/partner/v1/theft/active

{
  "count": 1,
  "results": [
    {
      "report_id": "9c1f…",
      "theft_datetime": "2026-07-01T22:15:00Z",
      "reported_at": "2026-07-02T08:03:00Z",
      "vehicle": {
        "vin": "JTDBT923771012345",
        "plate": "B-1234",
        "vehicle_type": "auto",
        "brand": "Toyota",
        "model": "Corolla",
        "color": "wit",
        "year": 2019
      }
    }
  ]
}

4. Eigen verbruik

GET /api/partner/v1/usage — aantal requests van de lopende kalendermaand per endpoint, plus de rate-limit en scopes van je key. Geen extra scope nodig.

Foutcodes

HTTP	Code	Betekenis
401	`MISSING_KEY / INVALID_KEY`	Key ontbreekt of is onbekend
403	`KEY_REVOKED / KEY_EXPIRED`	Key is ingetrokken of verlopen
403	`PARTNER_SUSPENDED`	Partner-toegang is opgeschort
403	`SCOPE_MISSING`	Key mist de benodigde scope
400	`EMPTY_QUERY / INVALID_VIN / INVALID_PLATE`	Invoer ontbreekt of heeft een ongeldig formaat
429	`RATE_LIMITED`	Rate-limit bereikt — zie Retry-After header
500	`LOOKUP_FAILED / AUTH_UNAVAILABLE`	Tijdelijke storing aan onze kant

Rate-limits gelden per key per minuut (standaard 60; afwijkende afspraken mogelijk). Bij 429 vertelt de Retry-After header wanneer je weer kunt.

Toegang nodig of vragen?

Mail ons op info@registrobonaire.com — vertel wie je bent en waarvoor je wilt koppelen, dan nemen we binnen twee werkdagen contact op.