> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usetapp.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Verify Account

> Resolve the account holder's name for an institution + account number before creating an order.

Confirms a payout account and returns the account holder's name. Recommended
before creating an order so transfers don't bounce.

<Note>
  `accountName` may be `"OK"` when the account is valid but the corridor returns
  no display name (e.g. KES M-Pesa). In that case, supply your own `accountName`
  on the order / recipient.
</Note>

### Header Parameters

<ParamField header="API-Key" type="string" required>
  Unique API key issued manually through Telegram.
</ParamField>

### Request Body

<ParamField body="institution" type="string" required>
  Institution code from [List Institutions](/api-reference/endpoint-list-institutions)
  (SWIFT code, or a custom code ending in `PC`).
</ParamField>

<ParamField body="accountIdentifier" type="string" required>
  Bank account number, mobile-money MSISDN, or Till/Paybill identifier. For
  mobile-money institutions, phone numbers are normalized (strips `+`, drops a
  leading domestic `0`, adds the country dial code — KES 254, UGX 256, TZS 255,
  GHS 233, MWK 265). e.g. `0712345678`, `+254712345678`, `254712345678` all
  resolve to `254712345678`.
</ParamField>

<ParamField body="metadata" type="object">
  Optional. Used for KES Till/Paybill so phone normalization is skipped (e.g.
  `channel: Till | Paybill`, `businessNumber`).
</ParamField>

### Response

<ResponseField name="status" type="string">Response state (`success`).</ResponseField>

<ResponseField name="data" type="object">
  <ResponseField name="accountName" type="string">
    The resolved account holder name, or `"OK"` (see note above).
  </ResponseField>
</ResponseField>

<RequestExample>
  ```json Request theme={null}
  {
    "institution": "GTBINGLA",
    "accountIdentifier": "0123456789"
  }
  ```
</RequestExample>

<ResponseExample>
  ```json Response (200 OK) theme={null}
  {
    "status": "success",
    "message": "Account name was fetched successfully",
    "data": { "accountName": "JOHN DOE" }
  }
  ```
</ResponseExample>