PE cédula de Extranjería

Endpoint: POST /migrations-pe/query

🚧 Datos de Sandbox:

A continuación listamos los datos definidos para el ambiente de sandbox:

document_typedocumentbirthdate
extranjeria12345678919/10/1976

Introducción

La cédula de Extranjería es el documento que representa fiscalmente a los extranjeros en Perú.

¿Para qué sirve?

El servicio de Extranjería de Perú te permite validar la información contenida en un número de cédula de Extranjería, registrada en dicha entidad.

Parámetros requeridos

PARÁMETROSDESCRIPCIÓN
document_type- Carné de Extranjería

- ptp permiso temporal de permanencia
documentNúmero de documento a consultar.
birthdateFecha de nacimiento (formato DD/MM/YYYY).

Posibles respuestas

STATUSDESCRIPCIÓN
document_data Datos documento de la persona.
personal_data Datos personales de la persona.

Consultar Cédula de Extranjería

POST /migrations-pe/query HTTP/1.1
Host: identity.sandbox.prometeoapi.com
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>

document_type=extranjeria&birthdate=26%2F11%2F1976&document=123456789
curl -X POST "https://identity.sandbox.prometeoapi.com/migrations-pe/query" -d "document_type=extranjeria&birthdate=26%2F11%2F1976&document=123456789" -H "X-API-Key: <API KEY>"
import requests

requests.post('https://identity.sandbox.prometeoapi.com/migrations-pe/query', data={
    'document_type': 'extranjeria',
    'birthdate': '26/11/1976',
    'document': '123456789',
}, headers={
    'X-API-Key': '<API KEY>'
})
var request = require('request');

request.post({
  "url": "https://identity.sandbox.prometeoapi.com/migrations-pe/query",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "form": {
    "document_type": "extranjeria",
    "birthdate": "26/11/1976",
    "document": "123456789"
  }
});

Respuesta exitosa

{
   "data": {
       "document_data": {
          "document_expiration": "Tiene Residencia Indefinida",
          "last_document_issuance": "19/10/2019",
          "migratory_quality": "ACUERDOS INTERNACIONALES - MERCOSUR",
          "residence_expiration": "19/10/2023"
       },
       "personal_data": {
          "birthdate": "26/11/1976",
          "name": "PEREZ, JUAN",
          "nationality": "COLOMBIANA"
       }
   },
   "errors": null
}

Respuesta errónea o parámetros inválidos/ausentes

{
   "data": null,
   "error": "Invalid parameters: date_end"
}

Respuesta errónea

{
   "data": null,
   "error": "Missing API key"
}