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

# Account resolver

> Verify a wallet, bank account, paybill or till and get the registered name.



## OpenAPI

````yaml POST /api/b2b/utilities/account/resolve
openapi: 3.1.0
info:
  title: Tanda API
  version: 1.0.0
  description: >-
    Collect and send KES payments in Kenya through M-PESA, Airtel Money and bank
    transfer.
servers:
  - url: https://api.tandapay.io
    description: Sandbox and production (your keys decide which)
security:
  - bearerAuth: []
tags:
  - name: Authentication
  - name: Account
  - name: Checkout
  - name: Collections
  - name: Payouts
  - name: Beneficiaries
  - name: Transactions
  - name: Reference data
  - name: Webhooks
paths:
  /api/b2b/utilities/account/resolve:
    post:
      tags:
        - Reference data
      summary: Account resolver
      description: >-
        Checks that a wallet, bank account, paybill or till exists and returns
        the registered name. Run it before a payout or before saving a
        beneficiary so you catch mistakes before money moves.
      operationId: account-resolver
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                accountNumber:
                  type: string
                  description: Phone, bank account, paybill or till number.
                  example: '254712345678'
                currency:
                  type: string
                  description: ISO 4217 currency code. Tanda supports `KES`.
                  enum:
                    - KES
                  example: KES
                method:
                  type: string
                  enum:
                    - momo
                    - bank
                    - paybill
                    - till
                  example: momo
                momoOperator:
                  type: string
                  description: Required for `momo`.
                  enum:
                    - mpesa
                    - airtel
                bankCode:
                  type: string
                  description: >-
                    Required for `bank`. From [Get
                    banks](/api-reference/endpoint/get-banks).
              required:
                - accountNumber
                - currency
                - method
            examples:
              momo:
                summary: M-PESA wallet
                value:
                  accountNumber: '254712345678'
                  currency: KES
                  method: momo
                  momoOperator: mpesa
              bank:
                summary: Bank account
                value:
                  accountNumber: '01100123456700'
                  currency: KES
                  method: bank
                  bankCode: '1243'
      responses:
        '200':
          description: Account found.
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    properties:
                      accountId:
                        type: string
                      accountName:
                        type: string
              example:
                success: true
                data:
                  accountId: '254712345678'
                  accountName: GRACE ACHIENG
        '400':
          description: The account couldn't be found or verified.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                success: false
                message: Account does not exist.
                errorCode: E-CH-PY.S-37
        '401':
          description: Missing, invalid or expired bearer token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                success: false
                message: Unauthorized
components:
  schemas:
    Error:
      type: object
      properties:
        success:
          type: boolean
          example: false
        message:
          type: string
          description: Human-readable; may change.
        errorCode:
          type: string
          description: Stable code to branch on.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Token from Generate bearer token.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.