List verifications

GET /v1/verifications

Returns your organization’s verifications, most recent first, with paging. Filter by scope or status. Listing is never charged.

Query parameters

integer

default:"1"

The page to return, starting at 1.

integer

default:"20"

Results per page, from 1 to 100. Values above 100 are capped at 100.

string

Return only checks for this scope, for example nin.

string

Return only checks with this status: found, not_found, or failed.

Request

curl "https://api.pruva.africa/v1/verifications?scope=nin&status=found&page=1&pageSize=20" \
  -H "X-Pruva-Key: pruva_live_YOUR_KEY"

const params = new URLSearchParams({ scope: "nin", status: "found", page: "1", pageSize: "20" });
const res = await fetch(`https://api.pruva.africa/v1/verifications?${params}`, {
  headers: { "X-Pruva-Key": "pruva_live_YOUR_KEY" },
});

const { data, meta } = await res.json();

import requests

res = requests.get(
    "https://api.pruva.africa/v1/verifications",
    headers={"X-Pruva-Key": "pruva_live_YOUR_KEY"},
    params={"scope": "nin", "status": "found", "page": 1, "pageSize": 20},
)

body = res.json()
data, meta = body["data"], body["meta"]

Response

Returns 200 with an array of verifications in data, and paging in meta.

{
  "status": true,
  "data": [
    {
      "reference": "43817179a3dc8c341d358432b0590924",
      "scope": "nin",
      "status": "found",
      "priceKobo": 5000,
      "charged": true,
      "createdAt": "2026-07-27T08:50:00+01:00"
    }
  ],
  "meta": {
    "total": 128,
    "page": 1,
    "pageSize": 20,
    "totalPages": 7
  }
}

Meta fields

integer

Total verifications matching the filters.

integer

The page returned.

integer

Results per page.

integer

Total pages available for these filters.

Paging

Request pages in order until page reaches totalPages. Keep the same filters on every request in a run, since changing them changes total and therefore the page boundaries.

​Query parameters

​Request

​Response

​Meta fields

​Paging

Query parameters

Request

Response

Meta fields

Paging