Colombia National ID Verification

Overview and Purpose

Overview

The Colombia National ID Verification API enables businesses to verify the identity of individuals in Colombia using official government-issued identification data. This API supports secure and reliable identity validation by cross-checking user-provided information against authoritative records. It is designed to help organizations streamline customer onboarding, reduce fraud risk, and maintain regulatory compliance while operating in the Colombian market. By integrating this API, businesses can verify identities without requiring direct integrations with local Colombian data providers. This service is particularly useful for industries that require strong identity verification processes, such as fintech, banking, insurance, gaming, and cryptocurrency platforms.

Key Features and Functionalities

Identity Verification The API validates key identity attributes including Cédula de Ciudadanía (CC) number and date of birth against official records to confirm the identity of Colombian citizens during onboarding and verification workflows. Extended Demographic Insights The API can return additional demographic attributes that support enhanced KYC checks, fraud detection, and risk assessment, enabling businesses to perform deeper identity verification. Fraud Prevention and Identity Protection By validating identity details against authoritative sources, the API helps reduce risks related to identity fraud, impersonation, and account misuse, ensuring that only legitimate users gain access to services.

API Details

Sample cURL

curl --location 'https://api-preproduction.signzy.app/api/v3/colombia-cc-verification' \
--header 'Content-Type: application/json' \
--header 'Authorization: ' \
--data '{
  "documentNumber": "123456",
  "issueDate": "2020-10-10"
}'
'

API Input

{
  "documentNumber": "123456",
  "issueDate": "2020-10-10"
}

Request Body Parameters

Parameter	Type	Description	Required
documentNumber	String	Unique number of the document	Yes
issueDate	String	Date when the document was issued (YYYY-MM-DD format)	Yes

Response

{
  "result": {
    "documentNumber": "<documentNumber>",
    "firstName": "<firstName>",
    "lastName": "<lastName>",
    "fullName": "<fullName>",
    "dob": "<dob>",
    "gender": "<gender>",
    "isAlive": "<isAlive>",
    "document": {
      "issueDate": "<issueDate>",
      "issuePlace": {
        "city": "<city>",
        "state": "<state>"
      }
    }
  },
"reason": "Request Successful", 
"code": "S001"
}

Response Body Parameters

Parameter	Type	Description
result	Object	Contains the verified personal and document details.
result.documentNumber	String	Unique identification document number.
result.firstName	String	First name of the individual.
result.lastName	String	Last name of the individual.
result.fullName	String	Full name of the individual as per the document.
result.dob	String	Date of birth of the individual (YYYY-MM-DD format).
result.gender	String	Gender of the individual (M/F).
result.isAlive	Boolean	Indicates whether the individual is alive.
result.document	Object	Contains document-related information.
result.document.issueDate	String	Date when the document was issued (YYYY-MM-DD format).
result.document.issuePlace	Object	Location where the document was issued.
result.document.issuePlace.city	String	City where the document was issued.
result.document.issuePlace.state	String	State where the document was issued.
reason	String	Message describing the result of the request.
code	String	Response status code indicating success or failure of the request.

Success Codes

HTTP Status Code	Success Code	Description
200	S001	Request Successful.
200	S003	Data not Found
200	S006	Data Partially Available

Error Codes

HTTP Status Code	Error Code	Description
400	E001	Bad Request
401	E101	Unauthorized Access
403	E201	Forbidden
404	E301	Data Not Found
409	E401	Upstream error
429	E501	Rate Limit Exceeded
500	E601	Internal Server Error
503	E701	Service Unavailable
504	E801	Timeout

Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!