Cédula panameña

POST/v1/cedula2 créditosIdentidadv1.0.0

Extrae los datos de la cédula panameña.

Petición

multipart/form-data con un solo campo:

Campo	Tipo	Descripción
`file`	archivo	JPEG, PNG, WEBP, GIF o PDF. Máximo 10 MB. Obligatorio.

curl

curl https://api.istmobot.com/v1/cedula \
  -H "Authorization: Bearer ib_live_..." \
  -F file=@documento.png

JavaScript

const form = new FormData();
form.append("file", fileBlob, "documento.png");
const res = await fetch("https://api.istmobot.com/v1/cedula", {
  method: "POST",
  headers: { Authorization: "Bearer ib_live_..." },
  body: form,
});
const { data, meta } = await res.json();

Respuesta

200 con data según la tabla y meta (request_id, credits_used, plugin_version, sandbox). Campos ausentes en el documento llegan como null.

Campo	Tipo	Descripción
`numero`	`string \| null`	Número de cédula normalizado, ej. 8-954-1813 o PE-12-345
`tipo`	`"panameno" \| "panameno_extranjero" \| "extranjero" \| "naturalizado" \| "indigena" \| null`	Deducido del prefijo: solo dígitos = panameño, PE = panameño nacido en el extranjero, E = extranjero, N = naturalizado, AV/PI = población indígena
`nombres`	`string \| null`	Nombres tal como aparecen impresos
`apellidos`	`string \| null`	Apellidos tal como aparecen impresos
`nombre_completo`	`string \| null`	Nombres y apellidos juntos
`fecha_nacimiento`	`string \| null`	ISO yyyy-mm-dd
`lugar_nacimiento`	`string \| null`	Lugar de nacimiento impreso, ej. PANAMÁ, PANAMÁ
`sexo`	`"M" \| "F" \| null`	M o F
`tipo_sangre`	`string \| null`	Tipo de sangre si está impreso, ej. O+
`fecha_expedicion`	`string \| null`	Fecha de expedición, ISO yyyy-mm-dd
`fecha_vencimiento`	`string \| null`	Fecha de vencimiento (EXPIRA), ISO yyyy-mm-dd
`vigente`	`boolean \| null`	true si la fecha de vencimiento es hoy o posterior
`mayor_de_edad`	`boolean \| null`	true si el titular tiene 18 años o más a la fecha de hoy
`mrz`	`string \| null`	Zona de lectura mecánica (3 líneas) si la foto es del reverso del diseño 2023

Ejemplo

{
  "data": {
    "numero": "8-000-0000",
    "tipo": "panameno",
    "nombres": "MARÍA FERNANDA",
    "apellidos": "GONZÁLEZ PÉREZ",
    "nombre_completo": "MARÍA FERNANDA GONZÁLEZ PÉREZ",
    "fecha_nacimiento": "1990-03-15",
    "lugar_nacimiento": "PANAMÁ, PANAMÁ",
    "sexo": "F",
    "tipo_sangre": "O+",
    "fecha_expedicion": "2020-01-10",
    "fecha_vencimiento": "2030-01-10",
    "vigente": true,
    "mayor_de_edad": true,
    "mrz": null
  },
  "meta": {
    "request_id": "req_3f9c2a",
    "credits_used": 2,
    "plugin_version": "1.0.0",
    "sandbox": false
  }
}

Con una key ib_test_ recibes exactamente este data con credits_used: 0 y sandbox: true.

Errores

401 key inválida · 402 sin créditos · 422 entrada inválida o extracción fallida · 429 rate limit. Formato en Errores.

Ver la solución · Probar en el explorador