API de verificación de cédula panameña (CCPA): formatos aceptados y consulta de nombre

Actualizado en noviembre de 2026

Esta guía muestra cómo verificar cédula en Panamá con la API de Verifik: el endpoint, sus parámetros, una solicitud que puedes pegar en la terminal, la respuesta y los errores documentados, y qué revisar al llevarlo a producción. Todo lo que sigue proviene de la documentación oficial del endpoint.

Sobre el documento: cédula en Panamá

La cédula de identidad personal de Panamá la emite el Tribunal Electoral. Su número sigue el patrón primer segmento – libro – tomo, y el primer segmento indica cómo la obtuvo el titular: un código de provincia del 1 al 13 para nacidos en Panamá, PE para panameños nacidos en el extranjero, E para extranjeros residentes, N para naturalizados, y los sufijos AV y PI para la serie anterior a 2006 y los registros indígenas.

El endpoint de Verifik usa el tipo de documento CCPA y normaliza estas variantes en el servidor antes de consultar el nombre registrado.

¿Quieres probarlo? Crea tu cuenta en Verifik y haz tu primera consulta hoy.

Cómo consultar la API de cédula de Panamá

Endpoint: GET https://api.verifik.co/v2/pa/cedula. Envía tu token en la cabecera Authorization: Bearer. Parámetros, según la documentación:

Ejemplo de solicitud con valores de ejemplo (reemplázalos por los datos de tu usuario):

curl --location --request GET 'https://api.verifik.co/v2/pa/cedula?documentType=CCPA&documentNumber=8-1234-12345' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

Respuesta 200 de la documentación (datos personales enmascarados):

{
  "data": {
    "documentType": "CCPA",
    "documentNumber": "8-****-**29",
    "firstName": "R******",
    "lastName": "M*******",
    "fullName": "R****** M*******"
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "January 16, 2024 3:44 PM"
  },
  "id": "PA001"
}

Una consulta exitosa devuelve HTTP 200 con un objeto data que contiene: documentType, documentNumber, firstName, lastName, fullName. Toda respuesta incluye además una signature (fecha y “Certified by Verifik.co”) y un id único que puedes guardar como evidencia de la verificación.

Errores documentados de /v2/pa/cedula

• 400 INVALID_DOCUMENT (“Invalid document number”): el número no pasó la validación; pide al usuario revisarlo antes de reintentar.
• 401 UNAUTHORIZED (“Authentication required”): falta el token o no es válido; revisa la cabecera Authorization.
• 409 MissingParameter (“missing documentNumber”): falta un parámetro obligatorio o tiene un valor no válido; corrige la solicitud en vez de reintentarla igual.
• 500 InternalServerError (“Server error”): error del servidor o de la fuente; reintenta con backoff y registra el id de la solicitud.

Consejos de integración

• Envía la cédula completa. El valor se recorta, pasa a mayúsculas y los separadores (espacios, /, _, ., guiones) se convierten en un solo guion; 10-AV-1234-12345 queda como 10AV-1234-12345.
• El libro tiene de 1 a 4 dígitos y el tomo de 1 a 6. Los códigos de provincia mayores a 13 se rechazan.
• Mantén el valor como texto. Algunos clientes HTTP convierten valores como E-8-197698 en notación científica; codifica bien la URL.
• Un valor incompleto devuelve 409 con un mensaje como Format incorrect: documentNumber.

Datos personales y términos de uso

Las consultas de identidad tratan datos personales. Usa la API solo con una finalidad legítima que puedas documentar, como onboarding, prevención de fraude o verificación contractual, obtén el consentimiento cuando la ley local lo exija y conserva solo los campos que necesites. El uso se rige por los términos y condiciones de smartCHECK.

Precios

Cada solicitud exitosa consume créditos de tu plan de Verifik. Los planes vigentes y el costo por endpoint están en la página de precios de smartCHECK.

Guías y documentación relacionadas

• API de consulta de RUC en Panamá
• API de verificación de cédula costarricense
• Documentación del endpoint (español)
• Documentación en inglés

Empieza a probar

Crea una cuenta en Verifik para obtener tu token de API, o agenda una reunión si quieres revisar cobertura y volúmenes con el equipo.