Get KYC Status

Get the current status of KYC verification

This endpoint will return the current KYC status mapped with the customerId only after the login OTP validation. First login to kycUrl link (received in /kyc/url), then check the kyc status.

GET the current KYC verification status.

POST https://integration.coinmena.com/onramp-bank/api/v1/kyc/status

Request Body

Name	Type	Description
customerId*	String	Unique id received from /kyc/url

200: OK

{
    "status": 1,
    "code": 200,
    "data": {
        "status": "COMPLETED",
        "updatedAt": "2023-09-29 02:55:14"
    }
}

400: Bad Request Missing required parameter

{
    "status": 0,
    "code": 400,
    "error": "Missing customerId."
}

500: Internal Server Error Internal Servor Error

{
    "status": 0,
    "code": 500,
    "error": "Internal Server Error."
}

Response

{
    "status": 1,
    "code": 200,
    "data": {
        "status": "COMPLETED",
        "updatedAt": "2023-09-29 02:55:14"
    }
}

Explanation

• status -> 0 is for unsuccessful request, 1 is for a successful one

• data -> current kycStatus can be

  • COMPLETED

  • BASIC_KYC_COMPLETED

  • INTERMEDIATE_KYC_COMPLETED

  • PERMANENT_FAILED

  • TEMPORARY_FAILED

  • IN_REVIEW

• updatedAt -> time when kyc status is updated.