Colombia

Colombia eKYC verification matches submitted individual data against Colombia's civil register as the source of truth. See the eKYC API Reference for common response semantics that apply across all sources.

Available sources

Source	API source string	Description
Colombia Civil Register 1	`CO_CIVIL_REGISTER_1`	Verifies submitted data against Colombia's civil register.

Colombia Civil Register 1

Request parameters

Parameter	Required	Description
`source`	Mandatory	Must be `CO_CIVIL_REGISTER_1`.
`country`	Mandatory	Must be `CO`.
`idNum`	Mandatory	Colombian Cédula de Ciudadanía. 8 to 10 numeric digits.
`firstName`	Mandatory	First name of the individual.
`middleName`	Optional	Middle name of the individual.
`surName`	Mandatory	Last name of the individual.
`issueDate`	Mandatory	Format: `yyyy-mm-dd`. Date the Cédula de Ciudadanía was issued.
`dateOfBirth`	Optional	Format: `yyyy-mm-dd`.
`gender`	Optional	Accepted values are `m` or `f`.

Sample request

{
    "plugins": ["kyc"], //required field
    "source": "CO_CIVIL_REGISTER_1", //required field
    "firstName": "Lukas", //required field
    "middleName": "Johannes",
    "surName": "Müller", //required field
    "idNum": "1234567890", //required field
    "dateOfBirth": "1991-08-02",
    "issueDate": "1991-08-02", //required field
    "gender": "m",
    "country": "CO" //required field
}

Response fields

Colombia Civil Register 1 anchors verification on the source-of-truth register. See the 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 Ciudadanía submitted against the value in the source of truth.
`issueDateMatch`	`exact`, `fuzzy`, `nomatch`, `nodata`	Matches ID issue date 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.
`genderMatch`	`exact`, `fuzzy`, `nomatch`, `nodata`	Matches gender 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 Ciudadanía:

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

{
    "kyc": [
        { "key": "firstNameMatch", "status": "exact" },
        { "key": "middleNameMatch", "status": "exact" },
        { "key": "lastNameMatch", "status": "exact" },
        { "key": "fullNameMatch", "status": "exact" },
        { "key": "idNumMatch", "status": "exact" },
        { "key": "genderMatch", "status": "nomatch" },
        { "key": "dobMatch", "status": "exact" },
        { "key": "issueDateMatch", "status": "exact" },
        { "key": "overallLevel", "status": "low" }
    ]
}