¿Preguntas?

Más información en nuestro Centro de Ayuda.

Centro de Ayuda
Contacto

Envíanos un mail con tu duda o sugerencia.

Contacto

API Identidad

Todas las requests deben incluir el API Key, ya sea usando el header X-API-Key o el parametro api_key en la url.

Para todos los ejemplos utilizaremos los mismos datos de prueba:

  • Código CURP

    • ABCD880304HDWXYZ45


Consultar CURP

Endpoint: POST /query

Parámetros Descripción
curp

El CURP de la persona a consultar.

Respuesta:

Status Descripción
document_data

Datos documento de la persona.

personal_data

Datos personales de la persona.

Consultar CURP

POST /query HTTP/1.1
Host: 
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>

curp=ABCD880304HDWXYZ45

Respuesta:

{
   "errors" : null,
   "pdf_url": "/pdf/81116a034e539b523b746944b35875b8.pdf",
   "data" : {
      "document_data" : {
         "foja" : "",
         "claveEntidadRegistro" : "25",
         "numActa" : "00064",
         "tomo" : "",
         "anioReg" : "1988",
         "municipioRegistro" : "GUASAVE",
         "libro" : "0001",
         "entidadRegistro" : "SINALOA",
         "claveMunicipioRegistro" : "011"
      },
      "personal_data" : {
         "sexo" : "HOMBRE",
         "entidad" : "DISTRITO FEDERAL",
         "nacionalidad" : "MEXICO",
         "statusCurp" : "RCN",
         "nombres" : "JUAN",
         "segundoApellido" : "GONZALEZ",
         "claveEntidad" : "DF",
         "docProbatorio" : 1,
         "fechaNacimiento" : "04/03/1986",
         "primerApellido" : "PEREZ",
         "curp" : "ABCD880304HDWXYZ45"
      }
   }
}

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"
}
curl -X POST "https:///query" -d "curp=ABCD880304HDWXYZ45" -H "X-API-Key: <API KEY>"

Respuesta:

{
   "errors" : null,
   "pdf_url": "/pdf/81116a034e539b523b746944b35875b8.pdf",
   "data" : {
      "document_data" : {
         "foja" : "",
         "claveEntidadRegistro" : "25",
         "numActa" : "00064",
         "tomo" : "",
         "anioReg" : "1988",
         "municipioRegistro" : "GUASAVE",
         "libro" : "0001",
         "entidadRegistro" : "SINALOA",
         "claveMunicipioRegistro" : "011"
      },
      "personal_data" : {
         "sexo" : "HOMBRE",
         "entidad" : "DISTRITO FEDERAL",
         "nacionalidad" : "MEXICO",
         "statusCurp" : "RCN",
         "nombres" : "JUAN",
         "segundoApellido" : "GONZALEZ",
         "claveEntidad" : "DF",
         "docProbatorio" : 1,
         "fechaNacimiento" : "04/03/1986",
         "primerApellido" : "PEREZ",
         "curp" : "ABCD880304HDWXYZ45"
      }
   }
}

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"
}
import requests

requests.post('https:///query', data={
    'curp': 'ABCD880304HDWXYZ45',
}, headers={
    'X-API-Key': '<API KEY>'
})

Respuesta:

{
   "errors" : null,
   "pdf_url": "/pdf/81116a034e539b523b746944b35875b8.pdf",
   "data" : {
      "document_data" : {
         "foja" : "",
         "claveEntidadRegistro" : "25",
         "numActa" : "00064",
         "tomo" : "",
         "anioReg" : "1988",
         "municipioRegistro" : "GUASAVE",
         "libro" : "0001",
         "entidadRegistro" : "SINALOA",
         "claveMunicipioRegistro" : "011"
      },
      "personal_data" : {
         "sexo" : "HOMBRE",
         "entidad" : "DISTRITO FEDERAL",
         "nacionalidad" : "MEXICO",
         "statusCurp" : "RCN",
         "nombres" : "JUAN",
         "segundoApellido" : "GONZALEZ",
         "claveEntidad" : "DF",
         "docProbatorio" : 1,
         "fechaNacimiento" : "04/03/1986",
         "primerApellido" : "PEREZ",
         "curp" : "ABCD880304HDWXYZ45"
      }
   }
}

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"
}
var request = require('request');

request.post({
  "url": "https:///query",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "form": {
    "curp": "ABCD880304HDWXYZ45"
  }
});

Respuesta:

{
   "errors" : null,
   "pdf_url": "/pdf/81116a034e539b523b746944b35875b8.pdf",
   "data" : {
      "document_data" : {
         "foja" : "",
         "claveEntidadRegistro" : "25",
         "numActa" : "00064",
         "tomo" : "",
         "anioReg" : "1988",
         "municipioRegistro" : "GUASAVE",
         "libro" : "0001",
         "entidadRegistro" : "SINALOA",
         "claveMunicipioRegistro" : "011"
      },
      "personal_data" : {
         "sexo" : "HOMBRE",
         "entidad" : "DISTRITO FEDERAL",
         "nacionalidad" : "MEXICO",
         "statusCurp" : "RCN",
         "nombres" : "JUAN",
         "segundoApellido" : "GONZALEZ",
         "claveEntidad" : "DF",
         "docProbatorio" : 1,
         "fechaNacimiento" : "04/03/1986",
         "primerApellido" : "PEREZ",
         "curp" : "ABCD880304HDWXYZ45"
      }
   }
}

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

Consultar datos personales

Endpoint: POST /reverse-query

Parámetros Descripción
state
  • AS Aguascalientes

  • BC Baja California

  • BS Baja California Sur

  • CC Campeche

  • CL Coahuila

  • CM Colima

  • CS Chiapas

  • CH Chihuahua

  • DF Ciudad de México

  • DG Durango

  • GT Guanajuato

  • GR Guerrero

  • HG Hidalgo

  • JC Jalisco

  • MC Estado de México

  • MN Michoacán

  • MS Morelos

  • NT Nayarit

  • NL Nuevo León

  • OC Oaxaca

  • PL Puebla

  • QT Querétaro

  • QR Quintana Roo

  • SP San Luis Potosí

  • SL Sinaloa

  • SR Sonora

  • TC Tabasco

  • TS Tamaulipas

  • TL Tlaxcala

  • VZ Veracruz

  • YN Yucatán

  • ZS Zacateca

  • NE Nacido en el extranjero

birthdate

Fecha de nacimiento (formato DD/MM/YYYY).

name

Nombres.

first_surname

Primer apellido.

last_surname

Segundo apellido.

gender
  • M Femenino

  • H Masculino

Respuesta:

Status Descripción
document_data

Datos documento de la persona.

personal_data

Datos personales de la persona.

pdf_url

URL del archivo PDF asociado a la persona.

Consultar datos personales

POST /reverse-query HTTP/1.1
Host: 
Accept: application/json
Content-Type: application/x-www-form-urlencoded
X-API-Key: <API KEY>

state=DF&birthdate=04%2F03%2F1986&name=Juan&first_surname=Perez&last_surname=Gonzalez&gender=H

Respuesta:

{
   "errors" : null,
   "pdf_url": "/pdf/81116a034e539b523b746944b35875b8.pdf",
   "data" : {
      "document_data" : {
         "foja" : "",
         "claveEntidadRegistro" : "25",
         "numActa" : "00064",
         "tomo" : "",
         "anioReg" : "1988",
         "municipioRegistro" : "GUASAVE",
         "libro" : "0001",
         "entidadRegistro" : "SINALOA",
         "claveMunicipioRegistro" : "011"
      },
      "personal_data" : {
         "sexo" : "HOMBRE",
         "entidad" : "DISTRITO FEDERAL",
         "nacionalidad" : "MEXICO",
         "statusCurp" : "RCN",
         "nombres" : "JUAN",
         "segundoApellido" : "GONZALEZ",
         "claveEntidad" : "DF",
         "docProbatorio" : 1,
         "fechaNacimiento" : "04/03/1986",
         "primerApellido" : "PEREZ",
         "curp" : "ABCD880304HDWXYZ45"
      }
   }
}

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"
}
curl -X POST "https:///reverse-query" -d "state=DF&birthdate=04%2F03%2F1986&name=Juan&first_surname=Perez&last_surname=Gonzalez&gender=H" -H "X-API-Key: <API KEY>"

Respuesta:

{
   "errors" : null,
   "pdf_url": "/pdf/81116a034e539b523b746944b35875b8.pdf",
   "data" : {
      "document_data" : {
         "foja" : "",
         "claveEntidadRegistro" : "25",
         "numActa" : "00064",
         "tomo" : "",
         "anioReg" : "1988",
         "municipioRegistro" : "GUASAVE",
         "libro" : "0001",
         "entidadRegistro" : "SINALOA",
         "claveMunicipioRegistro" : "011"
      },
      "personal_data" : {
         "sexo" : "HOMBRE",
         "entidad" : "DISTRITO FEDERAL",
         "nacionalidad" : "MEXICO",
         "statusCurp" : "RCN",
         "nombres" : "JUAN",
         "segundoApellido" : "GONZALEZ",
         "claveEntidad" : "DF",
         "docProbatorio" : 1,
         "fechaNacimiento" : "04/03/1986",
         "primerApellido" : "PEREZ",
         "curp" : "ABCD880304HDWXYZ45"
      }
   }
}

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"
}
import requests

requests.post('https:///reverse-query', data={
    'state': 'DF',
    'birthdate': '04/03/1986',
    'name': 'Juan',
    'first_surname': 'Perez',
    'last_surname': 'Gonzalez',
    'gender': 'H',
}, headers={
    'X-API-Key': '<API KEY>'
})

Respuesta:

{
   "errors" : null,
   "pdf_url": "/pdf/81116a034e539b523b746944b35875b8.pdf",
   "data" : {
      "document_data" : {
         "foja" : "",
         "claveEntidadRegistro" : "25",
         "numActa" : "00064",
         "tomo" : "",
         "anioReg" : "1988",
         "municipioRegistro" : "GUASAVE",
         "libro" : "0001",
         "entidadRegistro" : "SINALOA",
         "claveMunicipioRegistro" : "011"
      },
      "personal_data" : {
         "sexo" : "HOMBRE",
         "entidad" : "DISTRITO FEDERAL",
         "nacionalidad" : "MEXICO",
         "statusCurp" : "RCN",
         "nombres" : "JUAN",
         "segundoApellido" : "GONZALEZ",
         "claveEntidad" : "DF",
         "docProbatorio" : 1,
         "fechaNacimiento" : "04/03/1986",
         "primerApellido" : "PEREZ",
         "curp" : "ABCD880304HDWXYZ45"
      }
   }
}

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"
}
var request = require('request');

request.post({
  "url": "https:///reverse-query",
  "json": true,
  "headers": {
    "X-API-Key": "<API KEY>"
  },
  "form": {
    "state": "DF",
    "birthdate": "04/03/1986",
    "name": "Juan",
    "first_surname": "Perez",
    "last_surname": "Gonzalez",
    "gender": "H"
  }
});

Respuesta:

{
   "errors" : null,
   "pdf_url": "/pdf/81116a034e539b523b746944b35875b8.pdf",
   "data" : {
      "document_data" : {
         "foja" : "",
         "claveEntidadRegistro" : "25",
         "numActa" : "00064",
         "tomo" : "",
         "anioReg" : "1988",
         "municipioRegistro" : "GUASAVE",
         "libro" : "0001",
         "entidadRegistro" : "SINALOA",
         "claveMunicipioRegistro" : "011"
      },
      "personal_data" : {
         "sexo" : "HOMBRE",
         "entidad" : "DISTRITO FEDERAL",
         "nacionalidad" : "MEXICO",
         "statusCurp" : "RCN",
         "nombres" : "JUAN",
         "segundoApellido" : "GONZALEZ",
         "claveEntidad" : "DF",
         "docProbatorio" : 1,
         "fechaNacimiento" : "04/03/1986",
         "primerApellido" : "PEREZ",
         "curp" : "ABCD880304HDWXYZ45"
      }
   }
}

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

Consultar Carné de Migraciones de Perú

Endpoint: POST /migrations-pe/query

Parámetros Descripción
document_type
  • extranjeria carné de extranjería

  • ptp permiso temporal de permanencia

document

Número de documento a consultar.

birthdate

Fecha de nacimiento (formato DD/MM/YYYY).

Respuesta:

Status Descripción
document_data

Datos documento de la persona.

personal_data

Datos personales de la persona.

Consultar datos personales

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

document_type=extranjeria&birthdate=26%2F11%2F1976&document=123456789

Respuesta:

{
   "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"
}
curl -X POST "https:///migrations-pe/query" -d "document_type=extranjeria&birthdate=26%2F11%2F1976&document=123456789" -H "X-API-Key: <API KEY>"

Respuesta:

{
   "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"
}
import requests

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

Respuesta:

{
   "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"
}
var request = require('request');

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

Respuesta:

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

Especificación OpenAPI