Identidad

Extrae los datos de la cédula panameña

Una foto de la cédula y listo: número, nombres, fechas y si está vigente, sin transcribir nada.

Entrada: PDF o foto
Respuesta: JSON · Excel
Costo: 2 créditos

POST /v1/cedulaEjemplo de respuesta

{
  "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
}

Qué devuelve

Siempre los mismos campos. Lo que no aparece en el documento llega 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

Cómo usarla

Plataforma

Sube el archivo y ve el resultado. Descárgalo en Excel. Sin código.

API

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

Respuesta 202 con un id; el resultado llega por webhook o consultando el id. Referencia completa.

Para quién

Bancos, cooperativas y financieras que abren cuentas o aprueban créditos.
Registro de clientes en telefonía, seguros, alquileres y hospedaje.
Apps que verifican identidad o mayoría de edad al registrarse.

Preguntas frecuentes

¿Qué datos extrae de la cédula?

Número, tipo (panameño, extranjero, naturalizado, PE, indígena), nombres, apellidos, fecha y lugar de nacimiento, sexo, tipo de sangre, expedición y vencimiento.

¿Me dice si la cédula está vigente?

Sí. Devuelve vigente en true o false según la fecha de vencimiento, y mayor_de_edad según la fecha de nacimiento.

¿Qué cédulas acepta?

Cédulas panameñas vigentes, por la cara frontal. Si un formato no sale bien, cuéntanos y lo ajustamos.

¿Sirve una foto tomada con el celular?

Sí, en JPEG, PNG, WEBP o PDF. Mientras el texto se lea, funciona; lo que no se distingue llega como null.

¿Verifica la cédula contra el Tribunal Electoral?

No. Lee lo que está impreso en el documento y lo normaliza. No consulta registros externos.

Beta privada, sin costo.

Para negocios en Panamá.

Solicitar acceso