Method B: Get KYC Status

Testing Env

https://stage-api.fintegence.io

GET

/v1/kyc/status/{externalUserId}

Retrieves the current status of a user's KYC verification process. Use it to monitor progress and determine if further action is required from the user or your system.

The response indicates whether verification is pending, approved, or rejected, along with any rejection reasons.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

or

Path Params

Responses

🟢200Success

application/json

Bodyapplication/json

🟠401Access Denied

🟠404P412: User not exist

🟠404P445: KYC not found

🟠400P500: Unknown exception

🟠400P501: Service temporarily unavailable

🟠400P459: User not verified

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://stage-api.fintegence.io/v1/kyc/status/1d3c8a13-a2bf-4f0a-9631-723dfe892675' \
--header 'x-api-key: <api-key>'

Response Example

200 - Success

{
    "status": "NOT_VERIFIED",
    "attemptStatus": "PENDING"
}

Method B: Redirect to Verification

Add User Verification