Endpoint: taxi de Bogotá por tarjeta de control

Consulta por tarjeta de control los datos del taxi de Bogotá: placa, empresa y NIT, número de tarjeta de operación y vencimientos de SOAT, revisión técnico-mecánica y tarjeta de operación. No publica nombre, documento, fotografía, género ni sangre del conductor. Una tarjeta que no existe se entrega como hallazgo negativo y cobra; una respuesta que no se puede interpretar no cobra.

POST/api/taxi-bogota/card1 crédito

Taxi de Bogotá por tarjeta de control. Devuelve la tarjeta, placa, empresa/NIT, número de tarjeta de operación y vencimientos de SOAT/RTM/TO. No publica nombre, documento, foto, sangre ni género del conductor. Una tarjeta inexistente se devuelve como encontrado: false (cobra). Cuesta 1 crédito.

Cuerpo de la solicitud

body (JSON)
{
  "tarjeta": "TST123456789"
}
Parámetros del cuerpo de la solicitud
CampoTipoQué es
tarjetaobligatoriostringNúmero de tarjeta de control, de 6 a 20 letras o números. Alias: `tarjetaControl`, `card`.
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/taxi-bogota/card' \
  -H 'x-api-key: pk_live_TU_CLAVE' \
  -H 'content-type: application/json' \
  -d '{"tarjeta":"TST123456789"}'
JavaScript (fetch)
const res = await fetch("https://placapi.com/api/taxi-bogota/card", {
  method: "POST",
  headers: {
    "x-api-key": "pk_live_TU_CLAVE",
    "content-type": "application/json",
  },
  body: JSON.stringify({"tarjeta":"TST123456789"}),
});
const data = await res.json();
Python (requests)
import requests

res = requests.post(
    "https://placapi.com/api/taxi-bogota/card",
    headers={"x-api-key": "pk_live_TU_CLAVE"},
    json={"tarjeta":"TST123456789"},
)
data = res.json()

Respuesta exitosa

200 OK — ejemplo (placas y documentos ficticios)
{
  "source": "taxi-bogota",
  "status": "ok",
  "data": {
    "encontrado": true,
    "total": 1,
    "conductores": [
      {
        "tarjetaControl": "TST123456789",
        "placa": "TST123",
        "empresa": "EMPRESA DE PRUEBA S.A.S.",
        "nitEmpresa": "900000000",
        "numeroTarjetaOperacion": "0000000",
        "expedicion": "2026-10-27",
        "validez": "2026-11-23",
        "vigencia": "2026-11-23",
        "vencimientoSoat": "2026-11-26",
        "vencimientoRtm": "2026-11-22",
        "vencimientoTo": "2027-06-11"
      }
    ]
  },
  "mode": "live",
  "fetchedAt": "2026-07-24T15:04:05.000Z",
  "cost": 1
}

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: 30 de octubre de 2026 · PlacApi opera desde Colombia. PlacApi no es una entidad oficial del Gobierno.