Get Verification Status

Read on verification status of submitted user information

You can get the verification status of each KYC/KYB information (CIP tag) a user has submitted through this API. Only the status of submitted information will be presented here, however, you may be required to collect more information based on your spec sheet for a user's transaction to be processed.

The verification status can be any of the following. Details are also outlined here.

Verification Status	Description
SUBMIT	CIP tag has been successfully submitted
REVIEWING	CIP tag is under review
VERIFIED	CIP tag is verified
FAILED	CIP tag verification failed
REQUESTED	CIP tag is required for the user. This usually occurs when a user has created a transaction above their current tier limits and additional KYC information is required to further process the transaction.

GET /users/{{user_id}}/cip-info

Request Sample

curl --location --request GET '{{url}}/users/{{user_id}}/cip-info' \
--header 'X-Client-Id: {{client_id}}' \
--header 'X-Client-Secret: {{client_secret}}' \
--header 'Content-Type: application/json'

Response Sample

Individual user

{
	"cip_info": {
    	"GENDER": "VERIFIED",
    	"COUNTRY": "VERIFIED",
    	"STATE": "VERIFIED",
    	"LAST_NAME": "VERIFIED",
    	"OCCUPATION": "SUBMIT",
    	"CITY": "VERIFIED",
    	"ZIP_CODE": "VERIFIED",
    	"DATE_OF_BIRTH": "VERIFIED",
    	"ID_DOC": "VERIFIED",
    	"PHONE_NUMBER": "VERIFIED",
    	"EMAIL": "VERIFIED",
    	"ADDRESS_LINE1": "VERIFIED",
    	"MIDDLE_NAME": "SUBMIT",
    	"FIRST_NAME": "VERIFIED",
    	"IP_ADDRESS": "VERIFIED"
	},
	"kyc_status": "VERIFIED",
	"user_id": UUID
}

Business user

{
    "cip_info": {
        "NATURE_OF_BUSINESS": "VERIFIED",
        "COMPANY_TYPE": "VERIFIED",
        "EIN_NUMBER": "VERIFIED",
        "ACCOUNT_OPERATOR_INFO": "VERIFIED",
        "ZIP_CODE": "VERIFIED",
        "EMAIL": "VERIFIED",
        "CERTIFICATE_OF_INCORPORATION": "VERIFIED",
        "TXN_FREQUENCY": "VERIFIED",
        "NO_OF_EMPLOYEE": "VERIFIED",
        "DATE_OF_BIRTH": "VERIFIED",
        "EIN_DOC": "VERIFIED",
        "FIRST_NAME": "VERIFIED",
        "NO_OF_TXN_PER_MONTH": "VERIFIED",
        "MAILING_ADDRESS": "VERIFIED",
        "STATE": "VERIFIED",
        "SOURCE_OF_FUND": "VERIFIED",
        "ADDRESS_LINE1": "VERIFIED",
        "COUNTRY": "VERIFIED",
        "PHONE_NUMBER": "VERIFIED",
        "COMPANY_WEBSITE": "VERIFIED",
        "CITY": "VERIFIED"
    },
    "kyc_status": "VERIFIED",
    "user_id": {{UUID}}
}