Skip to main content
GET
/
identity
Get identity
curl --request GET \
  --url https://processor-prod.up.railway.app/identity \
  --header 'x-service-key: <api-key>'
{
  "success": true,
  "status": 200,
  "message": "Identity fetched successfully",
  "timestamp": "2025-09-08T20:18:48.483Z",
  "data": {
    "is_active": true,
    "id": "68bf2de7196a18d7bd165ffb",
    "type": "bvn",
    "details": {
      "bvn": "22284621397"
    }
  }
}

Authorizations

​
x-service-key
string
header
required

Query Parameters

​
identity_id
string
required

The identity ID to fetch details for

Example:

"68bf2de7196a18d7bd165ffb"

Response

200 - application/json

Identity fetched successfully

​
success
boolean
Example:

true

​
status
integer
Example:

200

​
message
string
Example:

"Identity fetched successfully"

​
timestamp
string<date-time>
Example:

"2025-09-08T20:18:48.483Z"

​
data
object