Forward a POST request to the Verification API

POST

/unified-verifs/{downstreamPath}

Proxies a POST request through to Flutterwave's Verification API (https://api.verification.flutterwave.com), on behalf of the authenticated caller. The path segment(s) after /unified-verifs/ (the downstreamPath) select which Verification API route is called; the request body and query string you send are forwarded to that route verbatim, and the Verification API's response — status code and body — is relayed back to you unchanged. Only downstream paths starting with v1/verifications or v1/banks are permitted; any other path is rejected before any upstream call is made. The Verification API's own internal secret key is injected server-side and is never exposed to callers. Every attempted call (including rejected ones) is recorded in a best-effort, PII-free audit log keyed off the caller's identity from the bearer token; audit logging failures never block the response.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Body Params application/json

Examples

Responses

🟢200

application/json

The downstream Verification API accepted the request and responded with a successful status. The response body is the Verification API's own JSON payload for that route, returned unchanged as data. The actual data shape depends entirely on the downstream route called and cannot be documented generically here.

Bodyapplication/json

🟠400

🟠401

⚪default

Request Example

Shell

JavaScript

Java

Swift

curl --location '/unified-verifs/v1/verifications' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "exampleField": "exampleValue"
}'

Response Example

200 - Success

{
    "message": null,
    "status": "success",
    "data": {
        "exampleField": "exampleValue"
    }
}

Modified at 2026-09-23 19:45:15

Proxy a PATCH request to the Verification API

List identity sessions