Get Verification Status and User's Data

GET https://fuspay-kyc-prod-e9eb4fd3aa33.herokuapp.com/api/v1/order/[email protected]

This endpoint is used to know the KYC status of your user. Where they are in the KYC Journey.

Request Header

Name	Type	Description
Content-type*	String	application/json

Query Parameters

Name	Description
email	user email
	system

verification_status is used to provide the actual KYC status of the user

Response Body

{
    "order": "66d8becdc456fb422bcb6d31",
    "status": "completed",
    "user_facial_images": {
        "image_1": "",
        "image_2": ""
    },
    "full_name": "Jibril  Ahmad ",
    "email": "[email protected]",
    "phone": "2347044974786",
    "reference": "6b671d7d-5784-452c-839e-e4892d951327",
    "address": "",
    "bvn": "",
    "country": "",
    "govt_id_no": "",
    "govt_id_photo": "",
    "proof_of_address": "",
    "bank_statement": "",
    "user_indemnity": "",
    "guarantors_form": "",
    "id_of_guarantor": "",
    "guarantors_proof_of_address": "",
    "verification_status": "rejected",
    "created_at": "2024-09-04T20:10:53.250Z",
    "updated_at": "2025-01-31T16:01:50.775Z",
    "meta_data": {
        "kyc_note": "Verification is complete but the data has been declined because Document is not visible or present in the proof.",
        "kyc_status": "rejected",
        "kyc_fee": 0
    }
}

Response Body Description

Key	Type	Description	Value
status	String	refers to the current state of the KYC process for an individual or business	UNPROCESSED
user's_facial_images	Array	These are the images of the user's face
_id	String	The identity number used to recognize and track the user in the verification process.
email	String	email of the user
full_name	String	full name of the user
phone	String	phone number of the user
app	String	This is your apps id
kyc_type	String	This is a string representing the KYC type. Each KYC type has an identifier
scan_ref	String	reference number or identifier that is associated with the verification process
verification_url	String	this is the link where your user is redirected to go and perform the KYC	http://localhost:5173/verification/individual/6687e6b301dd50bc5e48af12
callback	String	This is the URL where KYC status of your user would be posted after they have completed the KYC journey	https://custom-webhook-app-8b6d54acde1c.herokuapp.com/api/payload
reference	String	This is an identifier for your user from your end.	e.g. cee4d97b-c90b-425f-a902-0883b4b142ca
redirect	String	This is a URL where we would redirect your users after they have completed the KYC journey.
address	String	This is the house address of the user
bvn	String	This is the bank verification number of the user
country	String	This is the user's country
govt_id_no	String	This is the government identity number of the user
govt_id_photo	String	This is the user's government id photo
proof_of_address	String	This is the user's proof of address
bank_statement	String	This is the bank statement of the user
user_indemnity	String	This is the user's agreement to cover losses or liabilities from their actions. 4o
guarantors_form	String	This is the document where guarantors agree to cover obligations if the primary party defaults
id_of_guarantor	String	This is the id of the guarantor
guarantors_proof_of_address	String	This is the guarantors proof of address
created_at	Datetime	this is the time your app was registered on the KYC system	e.g. 2024-07-05T12:27:31.958Z
updated_at	Datetime	This is the last time a value was updated on your app's data	e.g. 2024-07-05T12:27:31.971Z
__v	Number
order	Array	A request to initiate the verification process or to check the status of a user's data.