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
-Validación de estructura por medio de expresiones regulares


Todos los métodos disponibles de la API reciben la petición por GET, por lo que podrás probar directo en tu navegador.

Se deberá registrar de forma gratuita y crear un proyecto. En este proyecto se generará un token que deberá enviar en una variable tipo GET para realizar su consulta. Para crear su cuenta deberá acceder a la siguiente URL:
https://api.valida-curp.com.mx/panel/registro

Para acceder a la API, se deberá ingresar al siguiente ENDPOINT:

https://api.valida-curp.com.mx/curp/{metodo}?{variables_get}&token={token}

• En donde {metodo} será el metodo a utilizar.
• En donde {variables_get} será una variable tipo GET condicional al método que se usará. En la descripción de cada método está el listado de variables disponibles.
• En donde {token} será una variable tipo GET obligatoria, será el token generado en su proyecto, con el que accederá a la API

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,
    "error_code": 0,
    "error_message": "",
    "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, quedando la estructura de esta forma:

https://api.valida-curp.com.mx/curp/{metodo}/?{variable}&token=pruebas

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

https://api.valida-curp.com.mx/curp/obtener_datos/?token=pruebas&curp=XAXX010101XAXAXA00

{
    "error": false,
    "code_error": 0,
    "error_message": "",
    "response": {
        "Solicitante": {
            "CURP": "XAXX010101XAXAXA00",
            "Nombres": "Nombre de prueba",
            "ApellidoPaterno": "Apellido paterno de prueba",
            "ApellidoMaterno": "Apellido materno de prueba",
            "ClaveSexo": "H",
            "Sexo": "Hombre",
            "FechaNacimiento": "01\/01\/1990",
            "Nacionalidad": "MEX",
            "ClaveEntidadNacimiento": "DF",
            "EntidadNacimiento": "Ciudad de México",
            "ClaveDocProbatorio": "1",
            "DocProbatorio": "Documento de pruebas",
            "ClaveStatusCurp": "XX",
            "StatusCurp": "Estatus de prueba"
        },
        "DocProbatorio": {
            "AnioRegistro": "1990",
            "ClaveEntidadEmisora": "999",
            "ClaveMunicipioRegistro": "999",
            "MunicipioRegistro": null,
            "Foja": "1",
            "FolioCarta": "0",
            "Libro": null,
            "NumActa": "999",
            "NumEntidadRegistrante": "",
            "EntidadRegistrante": "Ciudad de México",
            "NumRegExtranjeros": "",
            "Tomo": ""
        }
    }
}
                            

Validar estructura de un CURP

{
    "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 {obtener_datos} y se deberá enviar de forma obligatoria la variable tipo GET {curp} y {token}:

https://api.valida-curp.com.mx/curp/obtener_datos/?token=pruebas&curp=XAXX010101XAXAXA00

• 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 variable tipo GET obligatoria, con el cual se obtendrá la información de la persona dueña del curp

{
    "error": false,
    "code_error": 0,
    "error_message": "",
    "response": {
        "Solicitante": {
            "CURP": "PXNE660720HMCXTN06",
            "Nombres": "ENRIQUE",
            "ApellidoPaterno": "PEÑA",
            "ApellidoMaterno": "NIETO",
            "ClaveSexo": "H",
            "Sexo": "Hombre",
            "FechaNacimiento": "20\/07\/1966",
            "Nacionalidad": "MEX",
            "ClaveEntidadNacimiento": "MC",
            "EntidadNacimiento": "México",
            "ClaveDocProbatorio": "1",
            "DocProbatorio": "Acta de nacimiento",
            "ClaveStatusCurp": "AN",
            "StatusCurp": "Alta Normal"
        },
        "DocProbatorio": {
            "AnioRegistro": "1966",
            "ClaveEntidadEmisora": "",
            "ClaveMunicipioRegistro": "014",
            "MunicipioRegistro": "Atlacomulco",
            "Foja": "",
            "FolioCarta": "",
            "Libro": "",
            "NumActa": "00985",
            "NumEntidadRegistrante": "15",
            "EntidadRegistrante": "México",
            "NumRegExtranjeros": "",
            "Tomo": ""
        }
    }
}
                                         
                                         
                                    

Claves del estatus

Calcular un CURP por medio de datos de una persona

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