API de verificación de cédula paraguaya (CIC): consulta de nombre por número

Actualizado en noviembre de 2026

Esta guía muestra cómo verificar CIC en Paraguay 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: CIC en Paraguay

La Cédula de Identidad Civil (CIC) de Paraguay la expide el Departamento de Identificaciones de la Policía Nacional. Es un número de hasta siete u ocho dígitos y se usa en banca, contratos de telefonía y como base del RUC de las personas físicas.

El endpoint de Verifik solo necesita el número de documento y devuelve nombres, apellidos y nombre completo registrados.

Si ya tienes claro el caso de uso, crea una cuenta y prueba el endpoint desde tu código.

Cómo consultar la API de CIC de Paraguay

Endpoint: GET https://api.verifik.co/v2/py/cic. 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/py/cic?documentNumber=1234567' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer <token>'

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

{
  "data": {
    "documentNumber": "12***67",
    "firstName": "F*******",
    "lastName": "S****",
    "fullName": "F******* S****"
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "January 16, 2024 3:44 PM"
  },
  "id": "PY001"
}

Una consulta exitosa devuelve HTTP 200 con un objeto data que contiene: 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/py/cic

• 400 INVALID_DOCUMENT (“Invalid document number”): el número no pasó la validación; pide al usuario revisarlo antes de reintentar.

Consejos de integración

• Envía la CIC sin puntos ni separadores (muchos usuarios escriben 1.234.567).
• Este endpoint no usa documentType; solo documentNumber.
• Un 400 INVALID_DOCUMENT indica que el número no pasó la validación.
• Como la consulta solo requiere un número, agrega un segundo factor (selfie o foto del documento) en flujos de alto riesgo.

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 Paraguay
• API de verificación de cédula uruguaya
• 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.