Get a verification

GET /v1/verifications/{reference}

Retrieves a verification by its reference. Works for any scope, since a reference identifies a verification regardless of what was checked. Reading a result again is never charged and does not run a new check.

Path parameters

string

required

The reference returned when the check ran.

Request

curl https://api.pruva.africa/v1/verifications/43817179a3dc8c341d358432b0590924 \
  -H "X-Pruva-Key: pruva_live_YOUR_KEY"

const ref = "43817179a3dc8c341d358432b0590924";
const res = await fetch(`https://api.pruva.africa/v1/verifications/${ref}`, {
  headers: { "X-Pruva-Key": "pruva_live_YOUR_KEY" },
});

const verification = await res.json();

import requests

ref = "43817179a3dc8c341d358432b0590924"
res = requests.get(
    f"https://api.pruva.africa/v1/verifications/{ref}",
    headers={"X-Pruva-Key": "pruva_live_YOUR_KEY"},
)

verification = res.json()

Response

Returns 200 with the same verification resource you received when the check ran.

{
  "status": true,
  "data": {
    "reference": "43817179a3dc8c341d358432b0590924",
    "scope": "nin",
    "category": "kyc",
    "countryCode": "NG",
    "status": "found",
    "request": { "nin": "12345678901" },
    "result": {
      "firstName": "Ada",
      "lastName": "Okafor",
      "dateOfBirth": "1990-04-12"
    },
    "errorMessage": null,
    "priceKobo": 5000,
    "charged": true,
    "createdAt": "2026-07-27T08:50:00+01:00"
  }
}

The fields are identical to those returned by running a verification.

Errors

Code	When
`404`	No verification exists with that reference for your organization.
`401`	Missing or invalid API key.

A reference belongs to the organization that created it. A key from a different organization gets 404, not another org’s data.

⌘I

​Path parameters

​Request

​Response

​Errors

Path parameters

Request

Response

Errors