RUNT Citizen by Document
Look up a person in RUNT (Registro Único Nacional de Tránsito) by identification document: the driver record (name, registration id and date, person and driver status), every driving licence with its categories, issue and expiry dates, restrictions, retention, suspension and cancellation, traffic-fine standing (paz y salvo), procedure requests (solicitudes), driving-aptitude and medical certificates with their detail, CUPL registrations, SICOV validations, ANSV payments and identity-validation history. document_type defaults to CC. first_surname is optional: when omitted, the surname on record is used. found: false when the registry has no record for the document.
Supports async delivery: set Prefer: wait=N for an inline result, pass callback_url to receive a POST when ready, or poll GET /jobs/{id}.
Request
- Base URL: https://api.croma.run
- URL: https://api.croma.run/co/runt/citizen-by-document/v1
- Auth: HTTP bearer
Headers
Optional client-chosen key for this request (any string up to 255 characters, e.g. a UUID). Every Croma operation is an idempotent lookup: repeating a request with the same body returns the same result and creates nothing, so retrying after a timeout or network failure is always safe. The key is echoed back in the Idempotency-Key response header so you can correlate a retry with its first attempt. Each attempt that reaches the API counts against the rate limit.
Set wait=N to hold the connection up to N seconds for an inline result. If the job finishes in time you get the normal 200 body; otherwise a 202 with a status_url to poll.
Request body
Response
Successful response
Changes
No recorded changes to this operation across all 1 revision of this API.