List verifications

Return a list of verifications for your organization.

Query Parameters
  • type
    Type: stringenum

    Filter by verification type

    values
    • ACCOUNT_NUMBER
    • PHONE_NUMBER
    • BVN
    • LIPA_NA_MPESA
    • MPESA_AGENT
    • ADDRESS_VERIFICATION
  • status
    Type: stringenum

    Filter by status

    values
    • pending
    • success
    • failed
    • error
  • origin
    Type: stringenum

    Filter by where the verification was initiated

    values
    • api
    • dashboard
  • limit
    Type: integer
    max:  
    100

    Integer numbers.

  • offset
    Type: integer

    Integer numbers.

Responses
  • application/json
Request Example for get/verify
curl 'https://api.lira.com/api/v1/verify?type=ACCOUNT_NUMBER&status=pending&origin=api&limit=50&offset=0' \
  --header 'X-API-Key: YOUR_SECRET_TOKEN'
[
  {
    "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": "044",
    "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"
    }
  }
]