> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CURP Verifier

> RENAPO 데이터베이스를 사용한 멕시코 ID 검증을 위한 CURP Verifier API에 대해 알아보세요

CURP Verifier는 공식 멕시코 정부 데이터베이스인 Registro Nacional de Población (RENAPO)를 사용하여 멕시코 ID 문서의 CURP (Clave Única de Registro de Población) 번호를 검증하는 전문 API입니다. 이 API를 통해 클라이언트는 사용자의 CURP 번호를 검증하여 멕시코 사용자의 적절한 신원 확인을 보장할 수 있습니다.

## 주요 기능

* **공식 데이터베이스 통합**: 멕시코 정부 RENAPO 데이터베이스에 연결
* **CURP 검증**: 공식 기록에 대한 CURP 번호 검증
* **실시간 검증**: 즉시 검증 결과 제공
* **높은 정확도**: 공식 정부 데이터를 사용한 신뢰할 수 있는 검증
* **보안 처리**: 개인정보 보호를 위한 암호화된 데이터 전송
* **준수 준비**: 멕시코 정부 검증 표준 준수

## CURP란 무엇인가요?

CURP (Clave Única de Registro de Población)는 멕시코 시민과 거주자에게 할당되는 고유한 18자리 영숫자 코드입니다. 국가 식별 번호로 사용되며 다양한 정부 서비스와 공식 절차에 사용됩니다.

## 작동 방식

1. **CURP 입력**: 검증을 위한 CURP 번호 제출
2. **데이터베이스 쿼리**: 공식 RENAPO 데이터베이스 쿼리
3. **검증 확인**: CURP 진위성 및 유효성 검증
4. **데이터 검색**: 관련 개인정보 추출
5. **결과 생성**: 검증 상태 및 세부정보 제공

## API 엔드포인트

### CURP 검증 API

* **엔드포인트**: `POST /validate-curp`
* **목적**: CURP 번호 검증 및 관련 데이터 검색
* **입력**: CURP 번호 (필수)
* **출력**: 검증 상태 및 개인정보

## 입력 필드

### 필수 필드

<ParamField header="curpNumber" type="string" required>
  검증하고 데이터를 얻을 CURP 번호입니다. 이는 멕시코 시민에게 할당된 18자리 영숫자 코드입니다.
</ParamField>

### 선택 필드

<ParamField header="x-api-key" type="string">
  인증 및 접근 제어 목적으로 필수적인 API 키입니다.
</ParamField>

## CURP 상태값

### 활성 상태

<AccordionGroup>
  <Accordion title="AN - 일반 등록">
    활성 CURP 번호에 대한 일반 등록 상태입니다.
  </Accordion>

  <Accordion title="AH - 동음이의어 등록">
    참고: CURP의 첫 16자리가 이전 것과 동일하지만 신원 데이터나 등록 데이터가 없는 경우입니다.
  </Accordion>

  <Accordion title="RCC - CURP에 영향을 주는 등록 변경">
    참고: 키 자체에 영향을 주는 신원 또는 등록 데이터 변경을 겪은 CURP입니다.
  </Accordion>

  <Accordion title="RCN - CURP에 영향을 주지 않는 등록 변경">
    참고: 키 자체에 영향을 주지 않는 신원 또는 등록 데이터 변경을 겪은 CURP입니다.
  </Accordion>
</AccordionGroup>

### 비활성 상태

<AccordionGroup>
  <Accordion title="BAP - 위조 문서로 인한 해지">
    참고: 유효하지 않은 문서로 생성된 CURP입니다.
  </Accordion>

  <Accordion title="BSU - 사용하지 않아 해지">
    참고: 처음 발급된 이후 활동이 없는 CURP입니다. 즉, 확인, 인쇄, 사용 또는 이동이 없었습니다. 이러한 키를 재활성화하려면 CURP 모듈에서 요청해야 합니다.
  </Accordion>

  <Accordion title="BD - 사망으로 인한 해지">
    사망으로 인한 해지입니다.
  </Accordion>

  <Accordion title="BDM - 행정적 해지">
    참고: 문서 발급 기관의 요청으로 비활성화된 CURP입니다.
  </Accordion>

  <Accordion title="BDP - 입양으로 인한 해지">
    참고: 입양된 사람의 새로운 신원 데이터로 인해 비활성화된 CURP입니다.
  </Accordion>

  <Accordion title="BJD - 사법적 해지">
    참고: 법원 명령에 따른 요청으로 비활성화된 CURP입니다.
  </Accordion>
</AccordionGroup>

## 에러 코드

<ResponseField name="errorCode" type="string">
  에러 유형을 나타내는 에러 코드:

  * 1018: curpNumber가 필요합니다
  * 1019: CURP 번호 검증에 실패했습니다
</ResponseField>

<ResponseField name="message" type="string">
  에러에 대한 간단한 설명입니다.
</ResponseField>

## 사용 사례

* **은행**: 계좌 개설을 위한 멕시코 고객 신원 확인
* **정부 서비스**: 공식 서비스를 위한 사용자 인증
* **고용**: 직원 신원 및 작업 허가 확인
* **보험**: 정책 신청을 위한 고객 신원 확인
* **의료**: 의료 서비스를 위한 환자 신원 확인

## 지원 문서

* **멕시코 국민 ID**: INE/IFE 신분증
* **멕시코 여권**: 공식 여행 문서
* **출생 증명서**: 공식 출생 등록 문서
* **귀화 문서**: 시민권 증명서
* **기타 공식 문서**: 정부 발급 신분증

## 준수 및 보안

* **데이터 보호**: 멕시코 데이터 보호법 준수
* **암호화 전송**: 보안 데이터 전송 프로토콜
* **감사 추적**: 준수를 위한 검증 로그 유지
* **개인정보 중심**: 필요한 정보만 처리
* **정부 표준**: 공식 검증 요구사항 준수

## 시작하기

CURP Verifier를 사용하려면 다음이 필요합니다:

1. API 자격 증명 설정
2. 검증을 위한 CURP 번호 준비
3. 첫 번째 검증 요청 제출
4. 애플리케이션에서 검증 결과 처리


## OpenAPI

````yaml POST /verify/curp
openapi: 3.1.0
info:
  title: CURP Verifier API
  description: >-
    API for validating CURP (Clave Única de Registro de Población) numbers from
    Mexican ID documents using the official RENAPO database
  version: 1.0.0
servers:
  - url: https://idverify-api.argosidentity.com/modules
    description: Production server
security: []
paths:
  /verify/curp:
    post:
      tags:
        - CURP Verifier
      summary: Validate CURP number
      description: >-
        Validate CURP number from Mexican ID document using the official RENAPO
        database
      operationId: validateCurp
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - curpNumber
              properties:
                curpNumber:
                  type: string
                  description: CURP Number to validate and obtain data
                  example: MOOK930101HCCNRN04
      responses:
        '200':
          description: Successful CURP validation
          content:
            application/json:
              schema:
                type: object
                properties:
                  estatus:
                    type: string
                    description: Status of the verification request
                    example: OK
                  codigoValidacion:
                    type: string
                    description: Validation code for the verification request
                    example: vc1619806387.2754068
                  curp:
                    type: string
                    description: The CURP number that was validated
                    example: RAZR811012HVZMPB00
                  nombre:
                    type: string
                    description: Full name of the person associated with the CURP
                    example: RAMIRO ALONSO
                  apellidoPaterno:
                    type: string
                    description: Father's family name
                    example: RASCON
                  apellidoMaterno:
                    type: string
                    description: Mother's family name
                    example: ZAPATA
                  sexo:
                    type: string
                    description: Gender of the person
                    example: HOMBRE
                  fechaNacimiento:
                    type: string
                    description: Date of birth in DD/MM/YYYY format
                    example: 11/10/1981
                  paisNacimiento:
                    type: string
                    description: Country of birth
                    example: MEXICO
                  estadoNacimiento:
                    type: string
                    description: State of birth
                    example: VERACRUZ
                  docProbatorio:
                    type: number
                    description: Type of supporting document
                    example: 1
                  datosDocProbatorio:
                    type: object
                    description: Supporting document data
                    properties:
                      entidadRegistro:
                        type: string
                        description: Registry entity
                        example: VERACRUZ
                      tomo:
                        type: string
                        description: Volume Number
                      claveMunicipioRegistro:
                        type: string
                        description: Local Registry Number
                        example: '108'
                      anioReg:
                        type: string
                        description: Registered Year
                        example: '1983'
                      claveEntidadRegistro:
                        type: string
                        description: Entity Record Key
                        example: '30'
                      foja:
                        type: string
                        description: Page Number
                      numActa:
                        type: string
                        description: Record Number
                        example: '03382'
                      libro:
                        type: string
                        description: Book Number
                      municipioRegistro:
                        type: string
                        description: City of Registration
                        example: MINATITLÁN
                  estatusCurp:
                    type: string
                    description: >-
                      CURP status indicating the current state of the
                      registration
                    example: RCN
                  codigoMensaje:
                    type: string
                    description: Message code indicating the result of the verification
                    example: '0'
        '400':
          description: Bad request - Invalid parameters
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Brief description of the error
                  errorCode:
                    type: string
                    description: Error code indicating the type of error
                    enum:
                      - '1018'
                      - '1019'

````