🚧 Datos de Sandbox:

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

document_type	document	birthdate
`extranjeria`	`123456789`	`19/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ÁMETROS	DESCRIPCIÓN
document_type	Carné de Extranjería ptp permiso temporal de permanencia
document	Número de documento a consultar.
birthdate	Fecha de nacimiento (formato DD/MM/YYYY).

Posibles respuestas

STATUS	DESCRIPCIÓ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"
}