# Foreigner resident ID

The foreigner resident ID (Peru) verification service allows you to verify the identity of a foreign resident in Peru by their CE (Carné de Extranjería) number. The service returns the individual’s full name, given and family names, date of birth, nationality, immigration status, and residence details, including ID issuance and expiration dates


Endpoint: POST /services/pe/foreigner-id
Security: Your API key

## Request fields (application/json):

  - `document_number` (string,null, required)
    A number of a document

  - `dob` (string,null, required)
    The date of birth of a person, formatted according to ISO 8601

## Response 422 fields (application/json):

  - `type` (string)
    Example: "validation"

  - `errors` (array)
    Example: [{"parameter":"document_number","message":"Document number is required"},{"parameter":"dob","message":"Date of birth is required"}]

  - `errors.parameter` (string)

  - `errors.message` (string)

## Response 500 fields (application/json):

  - `type` (string)
    Example: "internal_server"

  - `errors` (array)