Con esta API muchas empresas han podido resolver problemas comunes en el registro de datos de sus usuarios. Ya que contamos con varias herramientas con las cuales se pueden validar, verificar y calcular un CURP. Entra las cuales destacan las siguientes:

-Obtención de datos por medio de un CURP
-Generación de CURP por medio de datos
-Validación de estructura por medio de un algoritomo


Todos los métodos disponibles de la API reciben la petición por POST, por lo que se deberá probar desde su servidor.

Se deberá registrar de forma gratuita y crear un proyecto. En este proyecto se generará un token que deberá enviar por medio del método POST para realizar su consulta. Para crear su cuenta deberá acceder a la siguiente URL:
https://api.valida-curp.com.mx/panel/registro

Para enviar el token de proyecto a nuestra API, existen 2 maneras: Dentro del JSON y dentro de los header.

HEADERS

Para enviar el token de proyecto por medio de los headers, se necesita enviar la siguiente cabecera

En este caso "{token}" se tendrá que remplazar por el token de proyecto

Ejemplo:

JSON

Para enviar el token en la estructura del JSON, solo se deberá añadir la clave "token" y darle el valor del token de proyecto

{
	"token" : {token}
}
									

En este caso "{token}" se tendrá que remplazar por el token de proyecto

Ejemplo:

{
	"token" : "pruebas"
}
									

Nota: Este ejemplo se estará utilizando en toda la documentación, pero se puede utilizar cualquiera de las 2 maneras para hacer la conexión a la API.

Para hacer uso de la API de forma correcta, se deberá estructurar un JSON con los datos solicitados según el método requerido

Ejemplo de un JSON a enviar:

{
    "token": "pruebas",
    "curp": "XAXX010101XAXAXA00",
}
										

NOTA:Todos las claves dentro del JSON a enviar deben estár escritas como se muestra en la documentación

Una vez que se haya hecho el request, el servidor regresará un código 200 http si todo salió de forma correcta, o devolverá un código 400 http si hubo un error en el envío de los parámetros al endpoint. En cualquier caso devolverá un json.

{
	"error":false,
	"code_error":0,
	"error_message": null,
	"response": {

	}
}
										 

• En donde {error} será una variable tipo bool. Indicará si hubo un error o no.
• En donde {error_code} será una variable tipo int. Indicará el número de error que podrá ser identificado en esta documentación.
• En donde {error_message} será una variable tipo string. Indicará error que hubo al momento de mandar la solicitud al servidor.
• En donde {response} será una variable tipo array. Devolverá la información de la validación.

Para realizar pruebas, se puede ocupar cualquier método disponible en esta documentación, únicamente se deberá ingresa la palabra {pruebas} en el valor de token.

https://validacurp-v2.qa-msweb.xyz/curp/{metodo}

En modo pruebas, mostrará información genérica y estática.

Ejemplo:

EndPoint:

https://validacurp-v2.qa-msweb.xyz/curp/getData

{
	"token": "pruebas",
	"curp": "PXNE660720HMCXTN06",
}
												
											

{
	"error":false,
	"code_error":0,
	"error_message":"",
	"response" : {
		"Applicant" : {
			"CURP":"XAXX010101XAXAXA00",
			"Names":"Nombre de prueba",
			"LastName":"Apellido paterno de prueba",
			"SecondLastName":"Apellido materno de prueba",
			"GenderKey":"H",
			"Gender":"Hombre",
			"DateOfBirth":"01\/01\/1990",
			"Nacionality":"MEX",
			"CodeEntityBirth":"DF",
			"EntityBirth":"Ciudad de México",
			"KeyEvidentiaryDocument":1,
			"EvidentiaryDocument":"Documento de pruebas",
			"CurpStatusKey":"XX",
			"StatusKey":"Estatus de prueba"
		},
		"EvidentiaryDocument" : {
			"YearRegistration":9999,
			"KeyIssuingEntity":999,
			"KeyMunicipalityRegistration":999,
			"MunicipalityRegistration":null,
			"Foja":1,
			"FolioLetter":0,
			"Book":null,
			"CertificateNumber":985,
			"RegistrantNumber":1,
			"RegistrationEntity":"México",
			"ForeignRegistrationNumber":"",
			"Volume":0
		}
	}
}
                            

Nota: La respuesta dependerá del método utilizado

Validar estructura de un CURP

{
    "token": "pruebas",
    "curp": "PXNE660720HMCXTN06",
}
										
										

{
    "error": false,
    "code_error": 0,
    "error_message": null,
    "response": {
        "valido": true
    }
}
										
										

Obtener datos de un CURP

Para acceder obtener los datos de un CURP dado, se deberá acceder al método {getData} y se deberá enviar de forma obligatoria las claves {curp} y {token}:

https://validacurp-v2.qa-msweb.xyz/curp/getData

• En donde {token} será el token asignado a su proyecto, con el que identificará su proyecto y le dará acceso a la API.
• En donde {curp} será una clave obligatoria, con el cual se obtendrá la información de la persona dueña del curp

Ejemplo:

https://validacurp-v2.qa-msweb.xyz/curp/getData

{
    "token": "pruebas",
    "curp": "PXNE660720HMCXTN06",
}
										
									

Respuesta del servidor:

										
{
	"error":false,
	"code_error":0,
	"error_message":"",
	"response": {
		"Applicant": {
			"CURP":"PXNE660720HMCXTN06",
			"Names":"ENRIQUE",
			"LastName":"PEÑA",
			"SecondLastName":"NIETO",
			"GenderKey":"H",
			"Gender":"Hombre",
			"DateOfBirth":"1966-07-20",
			"Nacionality":"MEX",
			"CodeEntityBirth":"",
			"EntityBirth":"",
			"KeyEvidentiaryDocument":1,
			"EvidentiaryDocument":"Acta de nacimiento",
			"CurpStatusKey":"RCN",
			"StatusKey":"Registro de cambio no afectando a CURP"
		},
		"EvidentiaryDocument": {
			"YearRegistration":1966,
			"KeyIssuingEntity":"",
			"KeyMunicipalityRegistration":14,
			"MunicipalityRegistration":"",
			"Foja":0,
			"FolioLetter":"",
			"Book":0,
			"CertificateNumber":985,
			"RegistrantNumber":15,
			"RegistrationEntity":"México",
			"ForeignRegistrationNumber":"",
			"Volume":0
		}
	}
}
										
									

Claves del estatus

Calcular un CURP por medio de datos de una persona

{
    "names" : "enrique",
	"lastName" : "peña",
	"secondLastName" : "nieto",
	"birthday" : "20",
	"birthMonth" : "07",
	"yearBirth" : "1966",
	"gender" : "H",
	"entity" : "15",
	"token" : "pruebas",
}
										
										

                                            
                                            
{
	"error":false,
	"code_error":0,
	"error_message":null,
	"response": { 
		"curp":"PXNE660720HMCXTN06"
	}
}
                                         
                                         

Obtener entidades disponibles CURP

                                            
                                            
{
    "error": false,
    "code_error": 0,
    "error_message": null,
    "response": {
        "clave_entidad": [
            {
                "clave_entidad": "01",
                "nombre_entidad": "AGUASCALIENTES",
                "abreviatura_entidad": "AS"
            },
            {
                "clave_entidad": "02",
                "nombre_entidad": "BAJA CALIFORNIA",
                "abreviatura_entidad": "BC"
            },
            {
                "clave_entidad": "03",
                "nombre_entidad": "BAJA CALIFORNIA SUR",
                "abreviatura_entidad": "BS"
            },
            {
                "clave_entidad": "04",
                "nombre_entidad": "CAMPECHE",
                "abreviatura_entidad": "CC"
            }

            .....


        ]
    }
}
                                         
                                         

Una vez que se haya hecho el request, el servidor regresará un código http 400 si hubo un error en el envío de los parámetros al endpoint.

En la siguiente tabla, se en listan los códigos de error:

Validación

En esta sección aparecerán los cambios hechos en la API, desde el día de su publicación

• 5/12/2021 - Se migró API a dominio principal Valida-CUPR.com.mx
• 5/08/2021 - Creación y publicación de la API