Endpoint: si un vehículo está apto para traspaso

Responde con un sí o un no si un vehículo está apto para traspaso, derivado de la ficha del RUNT: sin gravámenes, prendas, limitaciones a la propiedad ni garantías, y con el registro activo. Además de la bandera devuelve la lista de bloqueos concretos en texto listo para mostrar. El campo status distingue los casos: ok si está apto, danger si el bloqueo es un gravamen, una prenda o una limitación, y warn si lo único que falla es que el estado no sea ACTIVO. Es una lectura de los mismos gravámenes que ya trae /api/consulta, resumida en una decisión. Conviene cuando quien recibe la respuesta no es un desarrollador sino una pantalla de trámite: 'apto' o 'no apto' con el motivo, en vez de tres arreglos que alguien tiene que interpretar. Si necesitas el detalle de la prenda —acreedor, folio, fecha— ese vive en /api/garantias-rgm.

POST/api/apto-traspaso1 crédito

Semáforo SÍ/NO de si un vehículo está apto para traspaso, derivado del RUNT: sin gravámenes, prendas, limitaciones a la propiedad ni garantías, y con el registro activo. Devuelve el flag y la lista de bloqueos concretos en texto listo para mostrar. `status` es ok si está apto, danger si el bloqueo es un gravamen/prenda/limitación y warn si solo el estado no es ACTIVO.

Cuerpo de la solicitud

body (JSON)
{
  "placa": "ABC123",
  "docType": "CC",
  "docNumber": "1020304050"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
placaobligatoriostringPlaca del vehículo. 5 a 7 caracteres alfanuméricos: cubre AAA000, AAA00A y los formatos menos comunes (AAA00, AAAA00). Los guiones y espacios se ignoran.
docTypeobligatoriostringTipo de documento del propietario (CC, CE, NIT, PA, TI, CD, PPT, RC). Se aceptan alias comunes: PAS y PASAPORTE se normalizan a PA, y P.P.T. y P.P. —como lo abrevia la tarjeta de propiedad— se normalizan a PPT.Valores: CC · CE · NIT · PA · TI · CD · PPT · RC
docNumberobligatoriostringNúmero de documento del propietario. Alias aceptado: `doc`.
refreshbooleanIgnora la caché y vuelve a consultar la fuente oficial. Ojo: una consulta refrescada con datos siempre cobra (el hit de caché no).

Ejemplos por lenguaje

cURL
curl -X POST 'https://placapi.com/api/apto-traspaso' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"placa":"ABC123","docType":"CC","docNumber":"1020304050"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/apto-traspaso", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"placa":"ABC123","docType":"CC","docNumber":"1020304050"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/apto-traspaso",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"placa":"ABC123","docType":"CC","docNumber":"1020304050"},
)
data = res.json()

Respuesta exitosa

200 OK — datos ficticios de ejemplo
{
  "source": "vehiculo",
  "status": "ok",
  "data": {
    "placa": "ABC123",
    "aptoTraspaso": true,
    "estado": "ACTIVO",
    "bloqueos": [],
    "detalle": {
      "tieneGravamenes": false,
      "tienePrendas": false,
      "limitaciones": 0,
      "garantias": 0,
      "estadoDelVehiculo": "ACTIVO"
    }
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z"
}

Errores y cobro

Cuesta 1 crédito cuando devuelve datos. Códigos posibles: 400 401 402 404 429 500 502 — qué significa cada uno, cuál reintentar y cuál cobra, en errores y rate limits. Autenticación por x-api-key: cómo generar la clave.

Última revisión: 23 de agosto de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.

Contacto