Bank Account Verification in Côte d'Ivoire

Verify an Ivorian mobile-money account and retrieve the account holder's name before initiating a transfer.

Côte d'Ivoire account verification routes through the mobile-money operator's network. Most accounts in the Ivorian market are held with Orange Money.

Prerequisites

You'll need an API key. See Quickstart or Authentication if you don't have one yet.

Note: Verification endpoints use an API key in the X-API-Key header — not a Bearer token.

Make the verification request

curl -X POST https://api.lira.com/api/v1/verify/account \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "accountNumber": "4000000001",
    "country": "CI",
    "bankCode": "ORANGE"
  }'

Request body fields

Note: mode: "async" is not supported for Côte d'Ivoire in v1. All CI verifications are synchronous.

Supported operators

Read the result

Successful verification

{
  "id": "a1b2c3d4-...-...-...-...",
  "status": "success",
  "verificationType": "ACCOUNT_NUMBER",
  "identifier": "4000000001",
  "country": "CI",
  "verifiedAt": "2026-04-24T10:05:00.000Z",
  "verified": true,
  "accountNumber": "4000000001",
  "accountName": "Alpha Kouamé",
  "bankCode": "ORANGE"
}

Failed verification

{
  "id": "a1b2c3d4-...-...-...-...",
  "status": "failed",
  "verificationType": "ACCOUNT_NUMBER",
  "identifier": "4000000001",
  "country": "CI",
  "verifiedAt": "2026-04-24T10:05:00.000Z",
  "verified": false,
  "error": {
    "code": "ACCOUNT_NOT_FOUND",
    "message": "No account found for the provided details"
  }
}

Note: A 200 OK HTTP response does not mean the verification succeeded. Always check the status field.

Error handling

For the full error code reference, see Errors.

Next steps

• Phone Number in Côte d'Ivoire — verify Ivorian mobile-money subscribers
• Bank Account Overview — general bank account verification guide
• Errors — complete error code reference