Proxy a GET request to the Verification API

Forwards a GET request through core-service to the Flutterwave Verification API (https://api.verification.flutterwave.com), injecting the internal Verification API secret key server-side so callers never see or supply it themselves. Only downstream paths starting with v1/verifications or v1/banks are permitted; any other path is rejected before an upstream call is ever made. All query parameters on the request are forwarded verbatim to the corresponding Verification API route. A best-effort, PII-free audit record (caller identity, HTTP method, downstream path, upstream status code, outcome, duration) is persisted for every attempted call, including rejected and failed ones; audit persistence failures never block the response. When the downstream call reaches the Verification API, the response HTTP status code and JSON body are relayed back verbatim — including the Verification API's own 4xx/5xx errors, which are not treated as failures of this proxy endpoint. Because the response body is whatever the Verification API returns for the requested path, its exact shape cannot be documented generically here; it varies per downstream route and is not validated or transformed by core-service.

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

Query Params

Responses

🟢200

application/json

The most common outcome: the request reached the Verification API and it responded with an HTTP 200. The response envelope's status field is always "success" at the core-service level for any call that successfully reaches the Verification API — this reflects that the proxy call itself succeeded, not necessarily that the Verification API considered the request successful (see the default response below for how upstream 4xx/5xx are relayed).

Bodyapplication/json

🟠400

🟠401

🔴500

⚪default

{ "status": "success", "data": { "status": true, "message": "Verification retrieved", "data": { "bvn": "12345678901", "first_name": "Ada", "last_name": "Okafor" } } }