multiservicios-web/valida-curp

Validate, calculate and obtain CURP information in México.

v1.1.1 2025-05-18 04:34 UTC

Requires

• php: >=7.2.3
• ext-json: *
• guzzlehttp/guzzle: ^7.9

MIT

• Joel Rojas

• api
• client
• mexico
• curp
• valida

README

• This library can validate, calculate and gain CURP information in México.

• Copyright (c) Multiservicios Web JCA S.A. de C.V., https://multiservicios-web.com.mx

• More information: https://valida-curp.com.mx

• License: MIT (https://opensource.org/license/MIT)

1. Requirements

• PHP 7.2 or later

2. Installation

You can install this library via composer by following this command:

  composer require multiservicios-web/valida-curp

3. Account

3.1. Create an account

Create an account by following this link: https://valida-curp.tawk.help/article/registro-de-usuario

3.2. Create a project

Create a project by following this link: https://valida-curp.tawk.help/article/creaci%C3%B3n-de-proyecto

3.3. Get a token

Get your token by following this link: https://valida-curp.tawk.help/article/obtener-token-llave-privada-proyecto

4. Usage

4.1. include "autoload" file and import the library

<?php
require 'vendor/autoload.php';

use MultiserviciosWeb\ValidaCurp\Client as ValidaCurp;
use MultiserviciosWeb\ValidaCurp\ValidaCurpException;

4.2. Create an instance

The constructor receives as first parameter the token of the project.

$validaCurp = new ValidaCurp("YOUR-TOKEN");

4.3. (Optional) setVersion API

You can set the API version to query. You can set 1 or 2. The default value is 2.

$validaCurp->setVersion(1); //1 or 2

5. Methods

5.1. To validate CURP

The method "isValid()" takes a CURP as a parameter. To validate the structure CURP.

$validaCurp->isValid('PXNE660720HMCXTN06');

Response

stdClass Object
(
    [valido] => 1
)

5.2. To get CURP data

The method "getData()" takes a CURP as a parameter. To consult the CURP information in RENAPO.

$validaCurp->getData('PXNE660720HMCXTN06');

Response

stdClass Object
(
    [Applicant] => stdClass Object
        (
            [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] => AN
            [CurpStatus] => Alta Normal
        )

    [EvidentiaryDocument] => stdClass Object
        (
            [YearRegistration] => 1966
            [KeyIssuingEntity] => 
            [KeyMunicipalityRegistration] => 14
            [MunicipalityRegistration] => 
            [Foja] => 0
            [FolioLetter] => 
            [Book] => 0
            [CertificateNumber] => 985
            [RegistrantNumber] => 15
            [RegistrationEntity] => México
            [ForeignRegistrationNumber] => 
            [Volume] => 0
        )

)

5.3. To calculate a CURP

The method "calculate()" takes an array as parameter. To calculate the structure of a CURP with provided data. Receives an array with the following elements: [names, lastName, secondLastName, birthDay, birthMonth, birthYear, gender, entity]

$validaCurp->calculate([
    'names' => 'Enrique',
    'lastName' => 'Peña',
    'secondLastName' => 'Nieto',
    'birthDay' => '20',
    'birthMonth' => '07',
    'birthYear' => '1966',
    'gender' => 'H',
    'entity' => '15',
]);

Response

stdClass Object
(
    [curp] => PXNE660720HMCXTN06
)

5.4. To get entities

The method "getEntities()" doesn't take any parameters. To get the list of entities.

$validaCurp->getEntities();

Response

stdClass Object
(
    [clave_entidad] => Array
        (
            [0] => stdClass Object
                (
                    [clave_entidad] => 01
                    [nombre_entidad] => AGUASCALIENTES
                    [abreviatura_entidad] => AS
                )

            [1] => stdClass Object
                (
                    [clave_entidad] => 02
                    [nombre_entidad] => BAJA CALIFORNIA
                    [abreviatura_entidad] => BC
                ) ...

6. Full example

To see the full example click on this link https://github.com/hckdrkmx/validaCurp-client/blob/main/index.php

7. Credits

• Copyright (c) Multiservicios Web JCA S.A. de C.V., https://multiservicios-web.com.mx
• Author: Joel Rojas [e-mail]
• Grammatical corrections: Yesenia Armendáriz

8. License

This project is released under the MIT License. See the LICENSE file for details.