Verifications

List verifications

get/verify

Return a list of verifications for your organization.

Authorization

API key in the X-API-Key header.

Query parameters

typestring

Filter by verification type

Options: ACCOUNT_NUMBERPHONE_NUMBERBVNLIPA_NA_MPESAMPESA_AGENTADDRESS_VERIFICATION

statusstring

Filter by status

Options: pendingsuccessfailederror

originstring

Filter by where the verification was initiated

Options: apidashboard

limitinteger

offsetinteger

Request

curl -X GET 'https://api.lira.com/api/v1/verify' \
  -H 'X-API-Key: YOUR_API_KEY'

const response = await fetch('https://api.lira.com/api/v1/verify', {
  method: 'GET',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
  },
});

const data = await response.json();

import requests

response = requests.get(
    "https://api.lira.com/api/v1/verify",
    headers={"X-API-Key": "YOUR_API_KEY"},
)

data = response.json()

Response

[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "status": "success",
    "verificationType": "ACCOUNT_NUMBER",
    "identifier": "0123456789",
    "country": "NG",
    "verifiedAt": "2026-04-22T10:15:30.000Z",
    "verified": true,
    "origin": "api",
    "accountNumber": "0123456789",
    "accountName": "JANE DOE",
    "bankCode": "000014",
    "bankName": "Access Bank",
    "address": {
      "town": "Ikeja",
      "lga": "Ikeja",
      "state": "Lagos",
      "street": "15 Allen Avenue"
    },
    "identity": {
      "idType": "NIN",
      "idValue": "12345678901"
    },
    "error": {
      "code": "ACCOUNT_NOT_FOUND",
      "message": "Account number not found at the bank"
    }
  }
]