> ## 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, and global web search. Croma normalizes public-sector data into structured JSON for product teams and AI agents. 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: - 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 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: GHW899 document_type: CC document_number: '1000410698' responses: '200': description: Successful response headers: X-Request-Id: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string 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 still count against your quota. schema: type: string enum: - HIT - MISS 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: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string Retry-After: description: Seconds to wait before retrying. schema: type: integer 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: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ApiError' '401': description: Missing or invalid API key headers: X-Request-Id: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ApiError' '429': description: Rate limit exceeded headers: X-Request-Id: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string 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 Retry-After: description: Seconds to wait before retrying. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ApiError' '500': description: Internal error headers: X-Request-Id: description: >- Unique id for the request (req_…). Include it in support reports. schema: type: string content: application/json: schema: $ref: '#/components/schemas/ApiError' security: - bearerAuth: [] externalDocs: description: Interactive documentation and examples url: https://usecroma.com/colombia/runt components: schemas: RuntVehicleResponse: type: object required: - data properties: data: type: object required: - found - plate - vehicle - soat_policies - inspections - specifications - pledges - ownership_limitations - armoring - civil_liability - dijin_certificate - scrapping_certificate - normalization - scrapping properties: found: type: boolean description: >- Whether the plate and owner document have an active match. When false, vehicle is null and the lists are empty. plate: type: string vehicle: oneOf: - $ref: '#/components/schemas/RuntVehicle' - type: 'null' soat_policies: type: array items: $ref: '#/components/schemas/RuntSoatPolicy' description: SOAT policy history, newest first. inspections: type: array items: $ref: '#/components/schemas/RuntInspection' description: Técnico-mecánica (RTM) inspection history. specifications: oneOf: - $ref: '#/components/schemas/RuntSpecifications' - type: 'null' pledges: type: array items: $ref: '#/components/schemas/RuntPledge' description: >- Registered guarantees/liens (garantías), e.g. a bank prenda. Empty when unencumbered. ownership_limitations: type: array items: $ref: '#/components/schemas/RuntLimitation' armoring: oneOf: - $ref: '#/components/schemas/RuntArmoring' - type: 'null' description: Armoring (blindaje) record, or null when unarmored. civil_liability: type: array items: $ref: '#/components/schemas/RuntCivilLiability' dijin_certificate: oneOf: - $ref: '#/components/schemas/RuntDijinCertificate' - type: 'null' scrapping_certificate: oneOf: - $ref: '#/components/schemas/RuntScrappingCertificate' - type: 'null' normalization: type: array items: $ref: '#/components/schemas/RuntNormalization' scrapping: oneOf: - $ref: '#/components/schemas/RuntScrapping' - type: 'null' 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. RuntVehicle: type: object required: - plate - registration_status - vehicle_class - brand - line - model_year - vin - has_liens - has_pledges description: A vehicle's RUNT registry record. properties: plate: type: - string - 'null' registration_status: type: - string - 'null' service_type: type: - string - 'null' vehicle_class: type: - string - 'null' classification: type: - string - 'null' body_type: type: - string - 'null' brand: type: - string - 'null' line: type: - string - 'null' model_year: type: - string - 'null' color: type: - string - 'null' fuel_type: type: - string - 'null' engine_displacement: type: - number - 'null' doors: type: - number - 'null' seated_passengers: type: - number - 'null' total_passengers: type: - number - 'null' axle_count: type: - number - 'null' gross_weight: type: - number - 'null' load_capacity: type: - number - 'null' vin: type: - string - 'null' engine_number: type: - string - 'null' chassis_number: type: - string - 'null' serial_number: type: - string - 'null' traffic_license_number: type: - string - 'null' traffic_authority: type: - string - 'null' country_name: type: - string - 'null' registration_date: type: - string - 'null' format: date enrollment_date: type: - string - 'null' format: date days_registered: type: - number - 'null' has_liens: type: - boolean - 'null' has_pledges: type: - boolean - 'null' is_repowered: type: - boolean - 'null' is_classic: type: - boolean - 'null' is_teaching_vehicle: type: - boolean - 'null' is_state_security: type: - boolean - 'null' engine_restamped: type: - boolean - 'null' chassis_restamped: type: - boolean - 'null' serial_restamped: type: - boolean - 'null' vin_restamped: type: - boolean - 'null' RuntSoatPolicy: type: object required: - policy_number - insurer - is_current - expiry_date description: A SOAT (mandatory traffic-accident insurance) policy. properties: policy_number: type: - string - 'null' insurer: type: - string - 'null' is_current: type: - boolean - 'null' description: true for the currently-valid policy. issue_date: type: - string - 'null' format: date start_date: type: - string - 'null' format: date expiry_date: type: - string - 'null' format: date origin: type: - string - 'null' tariff_type: type: - string - 'null' RuntInspection: type: object required: - certificate_number - status - is_current - expiry_date description: A técnico-mecánica (RTM) inspection record. properties: certificate_number: type: - string - 'null' center_name: type: - string - 'null' inspection_type: type: - string - 'null' status: type: - string - 'null' is_current: type: - boolean - 'null' issue_date: type: - string - 'null' format: date expiry_date: type: - string - 'null' format: date plate: type: - string - 'null' RuntSpecifications: type: object required: - gross_weight - axle_count description: Extended specifications (dimensions, weights, capacities). properties: load_capacity: type: - number - 'null' gross_weight: type: - number - 'null' axle_count: type: - number - 'null' tire_count: type: - number - 'null' height: type: - number - 'null' width: type: - number - 'null' length: type: - number - 'null' total_passengers: type: - number - 'null' seated_passengers: type: - number - 'null' RuntPledge: type: object required: - creditor - registered_date description: A pledge (prenda) registered against the vehicle. properties: creditor: type: - string - 'null' creditor_document_type: type: - string - 'null' creditor_document_number: type: - string - 'null' registered_date: type: - string - 'null' format: date trust_estate: type: - string - 'null' RuntLimitation: type: object required: - limitation_type - issue_date description: An ownership limitation (limitación a la propiedad). properties: limitation_type: type: - string - 'null' document_number: type: - string - 'null' legal_entity: type: - string - 'null' department: type: - string - 'null' municipality: type: - string - 'null' issue_date: type: - string - 'null' format: date filing_date: type: - string - 'null' format: date RuntArmoring: type: object description: Armoring (blindaje) record for a vehicle. properties: is_armored: type: - boolean - 'null' level: type: - string - 'null' description: Armor level label, e.g. `TRES`. level_number: type: - number - 'null' armored_date: type: - string - 'null' format: date dearmored_date: type: - string - 'null' format: date resolution_number: type: - string - 'null' armoring_type: type: - string - 'null' certificate_issue_date: type: - string - 'null' format: date authorization: type: - string - 'null' RuntCivilLiability: type: object description: A civil-liability (responsabilidad civil) insurance policy. properties: policy_number: type: - string - 'null' insurer: type: - string - 'null' start_date: type: - string - 'null' format: date expiry_date: type: - string - 'null' format: date is_current: type: - boolean - 'null' RuntDijinCertificate: type: object description: DIJIN certificate (certificado-dijin). properties: certificate_number: type: - string - 'null' issue_date: type: - string - 'null' format: date issuing_entity: type: - string - 'null' status: type: - string - 'null' RuntScrappingCertificate: type: object description: Scrapping certificate (certificado-desintegración). properties: certificate_number: type: - string - 'null' status: type: - string - 'null' issue_date: type: - string - 'null' format: date scrapping_entity: type: - string - 'null' RuntNormalization: type: object description: A normalization (normalización) record. properties: initial_registration_deficiency: type: - boolean - 'null' normalized_status: type: - string - 'null' date: type: - string - 'null' format: date administrative_act_number: type: - string - 'null' RuntScrapping: type: object description: Scrapping (desintegración) status. properties: plate: type: - string - 'null' should_scrap: type: - boolean - 'null' securitySchemes: bearerAuth: type: http scheme: bearer description: 'Use Authorization: Bearer YOUR_API_KEY' ````