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_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"
}