---
title: "Venezuela"
url: "https://developer.incode.com/general-reference/venezuela/"
section: "general-reference"
group: "eKYC Reference / eKYC Coverage"
version: "v1.1"
status: "live"
---
# Venezuela


Venezuela eKYC verification matches submitted individual data against Venezuela's civil register as the source of truth. See the [eKYC API Reference](/general-reference/ekyc-api-reference/) for common response semantics that apply across all sources.

## Available sources

| Source                   | API source string    | Description                                                   |
| ------------------------- | ----------------------- | ------------------------------------------------------------------ |
| Venezuela Civil Register  | `VE_CIVIL_REGISTER`     | Verifies submitted data against Venezuela's civil register.        |

## Venezuela Civil Register

### Request parameters

| Parameter     | Required  | Description                                                                          |
| ------------- | --------- | --------------------------------------------------------------------------------------- |
| `source`      | Mandatory | Must be `VE_CIVIL_REGISTER`.                                                             |
| `country`     | Mandatory | Must be `VE`.                                                                            |
| `idNum`       | Mandatory | Venezuelan Cédula de Identidad (C.I.). 7 to 9 numeric digits.                            |
| `firstName`   | Mandatory | First name of the individual.                                                            |
| `middleName`  | Optional  | Middle name of the individual.                                                           |
| `surName`     | Mandatory | Last name of the individual.                                                             |
| `dateOfBirth` | Optional  | Format: `yyyy-mm-dd`.                                                                    |

### Sample request

```json
{
    "plugins": ["kyc"], //required field
    "source": "VE_CIVIL_REGISTER", //required field
    "firstName": "Maria", //required field
    "middleName": "Isabel",
    "surName": "Fernandez", //required field
    "idNum": "12345678", //required field
    "country": "VE", //required field
    "dateOfBirth": "1991-08-02"
}
```

### Response fields

Venezuela Civil Register anchors verification on the source-of-truth register. See the [eKYC API Reference](/general-reference/ekyc-api-reference/) for common match field definitions and status values.

| Field             | Statuses                              | Description                                                              |
| ------------------ | -------------------------------------- | ------------------------------------------------------------------------ |
| `firstNameMatch`  | `exact`, `fuzzy`, `nomatch`           | Matches first name submitted against the value in the source of truth.  |
| `middleNameMatch` | `exact`, `fuzzy`, `nomatch`, `nodata` | Matches middle name submitted against the value in the source of truth. |
| `lastNameMatch`   | `exact`, `fuzzy`, `nomatch`           | Matches last name submitted against the value in the source of truth.   |
| `fullNameMatch`   | `exact`, `fuzzy`, `nomatch`           | Matches full name submitted against the value in the source of truth.   |
| `idNumMatch`      | `exact`, `fuzzy`, `nomatch`, `nodata` | Matches Cédula de Identidad submitted against the value in the source of truth. |
| `dobMatch`        | `exact`, `fuzzy`, `nomatch`, `nodata` | Matches date of birth submitted against the value in the source of truth. |
| `overallLevel`    | `low`, `medium`, `high`               | Overall risk level. See below for calculation logic.                    |

### overallLevel calculation

`overallLevel` is calculated based on the risk associated with the submitted full name and Cédula de Identidad:

- `low` when `fullNameMatch` and `idNumMatch` are both `exact`.
- `high` when `fullNameMatch` or `idNumMatch` is `nomatch`.
- `medium` for all other combinations.

Contact your Incode representative to customize the `overallLevel` calculation for your use case.

### Sample response

```json
{
    "kyc": [
        { "key": "firstNameMatch", "status": "exact" },
        { "key": "middleNameMatch", "status": "exact" },
        { "key": "lastNameMatch", "status": "exact" },
        { "key": "fullNameMatch", "status": "exact" },
        { "key": "idNumMatch", "status": "exact" },
        { "key": "dobMatch", "status": "exact" },
        { "key": "overallLevel", "status": "low" }
    ]
}
```

<br />