> ## Documentation Index > Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt > Use this file to discover all available pages before exploring further. # RUNT Vehicle by Plate > Resolve a Colombian vehicle in RUNT (Registro Único Nacional de Tránsito) by plate and the registered owner's document. Returns the vehicle record (brand, line, model year, class, body, color, engine displacement, fuel, weights, VIN, engine/chassis/serial numbers, traffic authority, registration dates, lien/pledge flags) plus SOAT insurance history, técnico-mecánica (RTM) inspection history, extended technical data, registered guarantees/liens (with the creditor, e.g. a financing bank), ownership limitations, armoring (blindaje) status, civil-liability policies, DIJIN and scrapping certificates, normalization records, and scrapping status. `document_type` defaults to `CC`. `found: false` when the plate and owner document have no active match. 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}`. ## OpenAPI ````yaml /api-reference/openapi.json post /co/runt/vehicle-by-plate/v1 openapi: 3.1.0 info: title: Croma Marketplace API version: 1.0.0 description: >- Government-data APIs for Colombia, Peru, Mexico, United States, Brazil, El Salvador, Bolivia, and Japan, plus global web search. Croma normalizes public-sector data into structured JSON for product teams and AI agents. Every operation is a POST with a JSON body and an organization API key as a bearer token; every operation is an idempotent lookup and accepts an optional `Idempotency-Key` header. Paths carry their major version (`/v1`); the versioning and deprecation policy, including the `Deprecation` and `Sunset` headers a retiring endpoint sends, is at https://docs.usecroma.com/versioning. Rate limits are per organization and reported on every response (`RateLimit-Policy`, `X-RateLimit-*`): https://docs.usecroma.com/rate-limits. termsOfService: https://usecroma.com/en/terms contact: name: Croma support url: https://usecroma.com/en/support email: support@usecroma.com servers: - url: https://api.croma.run security: [] paths: /co/runt/vehicle-by-plate/v1: post: tags: - Colombia - RUNT summary: RUNT Vehicle by Plate description: >- Resolve a Colombian vehicle in RUNT (Registro Único Nacional de Tránsito) by plate and the registered owner's document. Returns the vehicle record (brand, line, model year, class, body, color, engine displacement, fuel, weights, VIN, engine/chassis/serial numbers, traffic authority, registration dates, lien/pledge flags) plus SOAT insurance history, técnico-mecánica (RTM) inspection history, extended technical data, registered guarantees/liens (with the creditor, e.g. a financing bank), ownership limitations, armoring (blindaje) status, civil-liability policies, DIJIN and scrapping certificates, normalization records, and scrapping status. `document_type` defaults to `CC`. `found: false` when the plate and owner document have no active match. 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}`. operationId: runt_vehicle_by_plate parameters: - $ref: '#/components/parameters/IdempotencyKey' - $ref: '#/components/parameters/Prefer' requestBody: required: true content: application/json: schema: type: object required: - plate - document_number properties: plate: type: string minLength: 6 maxLength: 6 pattern: ^[A-Za-z]{3}\d{2}[A-Za-z0-9]$ description: Colombian vehicle plate, e.g. `ABC123` or `ABC12D`. document_type: type: string enum: - CC - CE - TI - RC - PA - NIT - PPT default: CC description: Colombian document type. Defaults to `CC`. document_number: type: string minLength: 3 maxLength: 30 description: Document number (alphanumeric with hyphens allowed). callback_url: type: string format: uri description: POST the job result here when it finishes. additionalProperties: false example: plate: ABC123 document_type: CC document_number: '1234567890' responses: '200': description: Successful response headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' X-Cache: $ref: '#/components/headers/X-Cache' content: application/json: schema: $ref: '#/components/schemas/RuntVehicleResponse' '202': description: >- Accepted — the result is being computed asynchronously. Poll `job.status_url` (GET /jobs/{id}) or supply `callback_url` to have the result POSTed to you. Returned when `Prefer: wait` elapses before completion, or immediately when `callback_url` is set. headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' Retry-After: $ref: '#/components/headers/Retry-After' Location: description: Absolute URL to poll for job status. schema: type: string format: uri example: https://api.croma.run/jobs/run_123 X-Job-Id: description: Id of the created job. schema: type: string content: application/json: schema: $ref: '#/components/schemas/JobEnvelope' '400': description: Invalid request body headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: Missing or invalid API key headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: Rate limit exceeded headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' X-RateLimit-Limit: $ref: '#/components/headers/X-RateLimit-Limit' X-RateLimit-Remaining: $ref: '#/components/headers/X-RateLimit-Remaining' X-RateLimit-Reset: $ref: '#/components/headers/X-RateLimit-Reset' Retry-After: $ref: '#/components/headers/Retry-After' content: application/json: schema: $ref: '#/components/schemas/ApiError' '500': description: Internal error headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' '502': description: Upstream source returned an error headers: X-Request-Id: $ref: '#/components/headers/X-Request-Id' RateLimit-Policy: $ref: '#/components/headers/RateLimit-Policy' Idempotency-Key: $ref: '#/components/headers/Idempotency-Key' Deprecation: $ref: '#/components/headers/Deprecation' Sunset: $ref: '#/components/headers/Sunset' content: application/json: schema: $ref: '#/components/schemas/ApiError' security: - bearerAuth: [] externalDocs: description: Interactive documentation and examples url: https://docs.usecroma.com/guides/colombia/runt components: parameters: IdempotencyKey: name: Idempotency-Key in: header required: false description: >- 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. schema: type: string maxLength: 255 example: 0f8e9a42-6b7c-4d1e-9a3f-2c5d7e8f9a0b Prefer: name: Prefer in: header required: false description: >- 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. schema: type: string example: wait=30 headers: X-Request-Id: description: Unique id for the request (req_…). Include it in support reports. schema: type: string RateLimit-Policy: description: >- Quota policy for this endpoint as an IETF RateLimit-Policy structured field, e.g. `"default";q=100;w=86400` (100 requests per 86400-second window per organization). Endpoints with an extra hourly ceiling list both policies, e.g. `"webSearch";q=100;w=3600, "default";q=100;w=86400`. Present on every response, including 401 and 429. schema: type: string example: '"default";q=100;w=86400' Idempotency-Key: description: >- The `Idempotency-Key` the request carried, echoed back unchanged. Absent when the request sent none. schema: type: string Deprecation: description: >- Present only on an endpoint version scheduled for removal: the date the deprecation took effect (RFC 9745). A `Sunset` header and a `Link` with `rel="successor-version"` accompany it. Policy: https://docs.usecroma.com/versioning schema: type: string example: '@1767225600' Sunset: description: >- Present only on an endpoint version scheduled for removal: the date after which it answers 410 (RFC 8594). Announced in the changelog at least 90 days ahead. schema: type: string format: date-time example: Wed, 01 Apr 2026 00:00:00 GMT X-RateLimit-Limit: description: Requests allowed in the current window. schema: type: integer X-RateLimit-Remaining: description: Requests left before you are throttled. schema: type: integer X-RateLimit-Reset: description: ISO 8601 timestamp when the window resets. schema: type: string format: date-time X-Cache: description: >- HIT or MISS. Cached hits spend no credits, but still count toward an hourly ceiling. schema: type: string enum: - HIT - MISS Retry-After: description: Seconds to wait before retrying. schema: type: integer schemas: RuntVehicleResponse: type: object required: - data properties: data: $ref: '#/components/schemas/RuntVehicleData' JobEnvelope: type: object required: - job - data - error description: >- Returned by async-capable endpoints (202) and by GET /jobs/{id}. `data` holds the endpoint's normal result once `status` is `completed`; `error` is populated once `status` is `failed`. properties: job: type: object required: - id - status - endpoint - created_at - finished_at - status_url properties: id: type: string status: type: string enum: - queued - running - completed - failed - canceled - expired endpoint: type: string description: The endpoint path that created this job. created_at: type: - string - 'null' format: date-time finished_at: type: - string - 'null' format: date-time status_url: type: string format: uri description: GET this URL to poll the job. data: description: The endpoint's normal result object once completed; null until then. oneOf: - type: object - type: 'null' error: description: Populated once the job has failed; null otherwise. oneOf: - type: object required: - type - code - message properties: type: type: string code: type: string message: type: string - type: 'null' ApiError: type: object required: - error properties: error: type: object required: - type - code - message properties: type: type: string description: >- Broad category: invalid_request_error, authentication_error, not_found_error, rate_limit_error, upstream_error, api_error. code: type: string description: Machine-readable specific code. message: type: string description: Human-readable explanation, safe to surface in UI. param: type: string description: Field that triggered the error. Present on validation errors. details: type: object description: Free-form structured detail. RuntVehicleData: type: object properties: found: type: boolean plate: type: string vehicle: anyOf: - type: object properties: plate: anyOf: - type: string - type: 'null' registration_status: anyOf: - type: string - type: 'null' service_type: anyOf: - type: string - type: 'null' vehicle_class: anyOf: - type: string - type: 'null' classification: anyOf: - type: string - type: 'null' body_type: anyOf: - type: string - type: 'null' brand: anyOf: - type: string - type: 'null' line: anyOf: - type: string - type: 'null' model_year: anyOf: - type: string - type: 'null' color: anyOf: - type: string - type: 'null' fuel_type: anyOf: - type: string - type: 'null' engine_displacement: anyOf: - type: number - type: 'null' doors: anyOf: - type: number - type: 'null' seated_passengers: anyOf: - type: number - type: 'null' total_passengers: anyOf: - type: number - type: 'null' axle_count: anyOf: - type: number - type: 'null' gross_weight: anyOf: - type: number - type: 'null' load_capacity: anyOf: - type: number - type: 'null' vin: anyOf: - type: string - type: 'null' engine_number: anyOf: - type: string - type: 'null' chassis_number: anyOf: - type: string - type: 'null' serial_number: anyOf: - type: string - type: 'null' traffic_license_number: anyOf: - type: string - type: 'null' traffic_authority: anyOf: - type: string - type: 'null' country_name: anyOf: - type: string - type: 'null' registration_date: anyOf: - type: string - type: 'null' enrollment_date: anyOf: - type: string - type: 'null' days_registered: anyOf: - type: number - type: 'null' has_liens: anyOf: - type: boolean - type: 'null' has_pledges: anyOf: - type: boolean - type: 'null' is_repowered: anyOf: - type: boolean - type: 'null' is_classic: anyOf: - type: boolean - type: 'null' is_teaching_vehicle: anyOf: - type: boolean - type: 'null' is_state_security: anyOf: - type: boolean - type: 'null' engine_restamped: anyOf: - type: boolean - type: 'null' chassis_restamped: anyOf: - type: boolean - type: 'null' serial_restamped: anyOf: - type: boolean - type: 'null' vin_restamped: anyOf: - type: boolean - type: 'null' required: - plate - registration_status - service_type - vehicle_class - classification - body_type - brand - line - model_year - color - fuel_type - engine_displacement - doors - seated_passengers - total_passengers - axle_count - gross_weight - load_capacity - vin - engine_number - chassis_number - serial_number - traffic_license_number - traffic_authority - country_name - registration_date - enrollment_date - days_registered - has_liens - has_pledges - is_repowered - is_classic - is_teaching_vehicle - is_state_security - engine_restamped - chassis_restamped - serial_restamped - vin_restamped - type: 'null' soat_policies: type: array items: type: object properties: policy_number: anyOf: - type: string - type: 'null' insurer: anyOf: - type: string - type: 'null' is_current: anyOf: - type: boolean - type: 'null' issue_date: anyOf: - type: string - type: 'null' start_date: anyOf: - type: string - type: 'null' expiry_date: anyOf: - type: string - type: 'null' origin: anyOf: - type: string - type: 'null' tariff_type: anyOf: - type: string - type: 'null' required: - policy_number - insurer - is_current - issue_date - start_date - expiry_date - origin - tariff_type inspections: type: array items: type: object properties: certificate_number: anyOf: - type: string - type: 'null' center_name: anyOf: - type: string - type: 'null' inspection_type: anyOf: - type: string - type: 'null' status: anyOf: - type: string - type: 'null' is_current: anyOf: - type: boolean - type: 'null' issue_date: anyOf: - type: string - type: 'null' expiry_date: anyOf: - type: string - type: 'null' plate: anyOf: - type: string - type: 'null' required: - certificate_number - center_name - inspection_type - status - is_current - issue_date - expiry_date - plate specifications: anyOf: - type: object properties: load_capacity: anyOf: - type: number - type: 'null' gross_weight: anyOf: - type: number - type: 'null' axle_count: anyOf: - type: number - type: 'null' tire_count: anyOf: - type: number - type: 'null' height: anyOf: - type: number - type: 'null' width: anyOf: - type: number - type: 'null' length: anyOf: - type: number - type: 'null' total_passengers: anyOf: - type: number - type: 'null' seated_passengers: anyOf: - type: number - type: 'null' required: - load_capacity - gross_weight - axle_count - tire_count - height - width - length - total_passengers - seated_passengers - type: 'null' pledges: type: array items: type: object properties: creditor: anyOf: - type: string - type: 'null' creditor_document_type: anyOf: - type: string - type: 'null' creditor_document_number: anyOf: - type: string - type: 'null' registered_date: anyOf: - type: string - type: 'null' trust_estate: anyOf: - type: string - type: 'null' required: - creditor - creditor_document_type - creditor_document_number - registered_date - trust_estate ownership_limitations: type: array items: type: object properties: limitation_type: anyOf: - type: string - type: 'null' document_number: anyOf: - type: string - type: 'null' legal_entity: anyOf: - type: string - type: 'null' department: anyOf: - type: string - type: 'null' municipality: anyOf: - type: string - type: 'null' issue_date: anyOf: - type: string - type: 'null' filing_date: anyOf: - type: string - type: 'null' required: - limitation_type - document_number - legal_entity - department - municipality - issue_date - filing_date armoring: anyOf: - type: object properties: is_armored: anyOf: - type: boolean - type: 'null' level: anyOf: - type: string - type: 'null' level_number: anyOf: - type: number - type: 'null' armored_date: anyOf: - type: string - type: 'null' dearmored_date: anyOf: - type: string - type: 'null' resolution_number: anyOf: - type: string - type: 'null' armoring_type: anyOf: - type: string - type: 'null' certificate_issue_date: anyOf: - type: string - type: 'null' authorization: anyOf: - type: string - type: 'null' required: - is_armored - level - level_number - armored_date - dearmored_date - resolution_number - armoring_type - certificate_issue_date - authorization - type: 'null' civil_liability: type: array items: type: object properties: policy_number: anyOf: - type: string - type: 'null' insurer: anyOf: - type: string - type: 'null' start_date: anyOf: - type: string - type: 'null' expiry_date: anyOf: - type: string - type: 'null' is_current: anyOf: - type: boolean - type: 'null' required: - policy_number - insurer - start_date - expiry_date - is_current dijin_certificate: anyOf: - type: object properties: certificate_number: anyOf: - type: string - type: 'null' issue_date: anyOf: - type: string - type: 'null' issuing_entity: anyOf: - type: string - type: 'null' status: anyOf: - type: string - type: 'null' required: - certificate_number - issue_date - issuing_entity - status - type: 'null' scrapping_certificate: anyOf: - type: object properties: certificate_number: anyOf: - type: string - type: 'null' status: anyOf: - type: string - type: 'null' issue_date: anyOf: - type: string - type: 'null' scrapping_entity: anyOf: - type: string - type: 'null' required: - certificate_number - status - issue_date - scrapping_entity - type: 'null' normalization: type: array items: type: object properties: initial_registration_deficiency: anyOf: - type: boolean - type: 'null' normalized_status: anyOf: - type: string - type: 'null' date: anyOf: - type: string - type: 'null' administrative_act_number: anyOf: - type: string - type: 'null' required: - initial_registration_deficiency - normalized_status - date - administrative_act_number scrapping: anyOf: - type: object properties: plate: anyOf: - type: string - type: 'null' should_scrap: anyOf: - type: boolean - type: 'null' required: - plate - should_scrap - type: 'null' required: - found - plate - vehicle - soat_policies - inspections - specifications - pledges - ownership_limitations - armoring - civil_liability - dijin_certificate - scrapping_certificate - normalization - scrapping securitySchemes: bearerAuth: type: http scheme: bearer description: 'Use Authorization: Bearer YOUR_API_KEY' ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.