Carnet de extranjería
Nombres y apellidos del titular de un carnet de extranjería. Esta API está en preparación y hoy responde 501 sin descontar créditos.
GET
https://api.endpoint.pe/v1/ce/{numero}- Fuente:
- Migraciones
- Costo:
- 1 crédito por consulta con resultado
- Estado:
- Disponible pronto
Disponible pronto
Estamos conectando la fuente oficial. La ruta ya existe y valida el formato del número, pero responde 501 no_disponible sin descontar créditos. Cuando se active, la respuesta tendrá el formato de abajo.
Parámetros
| Nombre | Dónde | Formato |
|---|---|---|
numero | Ruta | 9 a 12 caracteres alfanuméricos. Si no cumple, la API responde 422. |
Formato previsto
El ejemplo usa un número y una persona ficticios.
terminal
curl 'https://api.endpoint.pe/v1/ce/001234567' \ -H 'Authorization: Bearer TU_TOKEN'respuesta.json
{ "success": true, "message": "Consulta exitosa", "data": { "numero": "001234567", "nombres": "CARLOS ANDRÉS", "apellido_paterno": "RODRÍGUEZ", "apellido_materno": "PÉREZ" }, "meta": { "fuente": "Migraciones", "consultado_en": "2026-10-12T07:40:12Z", "creditos_cobrados": 1, "creditos_disponibles": 14621 }}Campos previstos de data
| Campo | Descripción |
|---|---|
| numero | Número de carnet consultado. |
| nombres | Nombres del titular. |
| apellido_paterno | Apellido paterno. |
| apellido_materno | Apellido materno. |
Respuesta actual
Mientras la fuente no esté conectada, toda consulta con formato válido responde:
respuesta.json
{ "success": false, "message": "Esta fuente aún no está conectada. Estará disponible pronto.", "error": "no_disponible", "data": null, "meta": { "consultado_en": "2026-10-12T08:41:49Z" }}Qué es el documento y cómo validarlo mientras tanto: Carnet de extranjería: qué es y cómo validarlo.
Errores
| HTTP | error | Cuándo |
|---|---|---|
| 501 | no_disponible | Siempre, hasta que la fuente esté conectada. No descuenta créditos. |
| 422 | validacion | detalles.numero: "Carnet de extranjería inválido: 9 a 12 caracteres alfanuméricos." |
Los demás códigos (401, 402, 403) son comunes a todas las APIs: Errores.
Relacionados
- API de carnet de extranjería: qué devuelve, para qué se usa y preguntas frecuentes.
- Playground: prueba la consulta desde el navegador con tu API key.
- Carnet de extranjería: qué es y cómo validarlo
- Cómo validar un DNI en tu sistema: formato y RENIEC
- Ley de protección de datos personales: guía para desarrolladores
- Validar RUC y DNI en el frontend y en el backend
En esta página