Errores y rate limits
La API de PlacApi usa códigos HTTP estándar. Cada consulta devuelve además el estado por fuente dentro del JSON, así que un 200 puede incluir fuentes con status error sin que falle toda la llamada.
Códigos de error
| HTTP | Nombre | Significado | Qué hacer |
|---|---|---|---|
| 401 | Unauthorized | Falta la API key o es inválida/revocada. | Envía x-api-key: pk_live_… válida. |
| 402 | Payment Required | La cuenta no tiene créditos suficientes. | Compra créditos en /comprar. |
| 422 | Unprocessable Entity | El cuerpo no pasa validación (placa o documento con formato incorrecto). | Revisa placa, docType y docNumber. |
| 429 | Too Many Requests | Se superó el rate limit. | Aplica backoff exponencial y reintenta. |
| 500 | Internal Server Error | Error interno inesperado. | Reintenta; si persiste, contacta soporte. |
| 502 / 503 | Bad Gateway / Service Unavailable | Una fuente oficial no respondió a tiempo. | Reintenta más tarde; la fuente afectada llega con status error. |
Cobro de créditos
Solo se descuenta 1 crédito cuando la consulta devuelve datos del vehículo (vehicle.data presente). Si todas las fuentes fallan, no se cobra.
Rate limits y reintentos
Ante un 429, aplica backoff exponencial (por ejemplo 1s, 2s, 4s) con un tope de reintentos. Ante 502/503, la fuente oficial estaba caída; reintenta más tarde. Si necesitas límites más altos para volumen, escríbenos.
Ver autenticación y la documentación.
Última revisión: 11 de julio de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.