> ## Documentation Index
> Fetch the complete documentation index at: https://developer.me-cash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Account Enquiry

> Retrieves details about a specific bank account.



## OpenAPI

````yaml post /v1/account/enquiry
openapi: 3.0.3
info:
  title: meCash API
  version: 3.0.3
  description: >-
    API for meCash services, including FIAT and Ramp operations. This is the
    OpenAPI specification for the meCash API, covering all available endpoints
    for wallet management, currency quotes, and payouts.


    It follows a design-first approach based on OpenAPI 3.0.


    Authentication is handled via an API key passed in the `x-api-key` header.
    Replace `YOUR_API_KEY` with your actual key when making requests.


    Some useful links:

    - [meCash Documentation](https://docs.me-cash.com/)

    - [Authentication Guide](https://docs.me-cash.com/authentication)
servers:
  - url: https://sandboxapi.me-cash.com
    description: Sandbox Server for Testing
security:
  - ApiKeyAuth: []
tags:
  - name: Wallet
    description: Wallet management operations
  - name: Quote
    description: Currency quote operations
  - name: Payout
    description: Payout operations
  - name: Transaction
    description: Transaction management
  - name: Virtual Account
    description: Virtual account operations for static and dynamic accounts
  - name: Bank
    description: Bank account and list operations
  - name: Ramp
    description: Ramp operations for crypto
  - name: Miscellaneous
    description: Utility and miscellaneous operations
  - name: Collection
    description: Mobile money and wallet funding operations
  - name: Bulk Payout
    description: >-
      Bulk transfer operations for sending to multiple beneficiaries in a single
      request
paths:
  /v1/account/enquiry:
    post:
      tags:
        - Bank
      summary: Account Enquiry
      description: Retrieves details about a specific bank account.
      operationId: enquireAccountDetails
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateAccountEnquiryRequest'
            example:
              currency: NGN
              country: NG
              account:
                accountNumber: '0690000032'
                sortCode: '044'
      responses:
        '200':
          description: Account details fetched successfully.
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/Success'
                  - type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/AccountEnquiry'
        '401':
          $ref: '#/components/responses/PayoutUnauthorized'
        '403':
          $ref: '#/components/responses/PayoutForbidden'
        '404':
          $ref: '#/components/responses/EnquiryAccountNotFound'
        '422':
          $ref: '#/components/responses/EnquiryValidationFailed'
components:
  schemas:
    CreateAccountEnquiryRequest:
      type: object
      required:
        - currency
        - country
        - account
      properties:
        currency:
          type: string
          description: Currency code (e.g., NGN)
          example: NGN
        country:
          type: string
          description: Country code (e.g., NG)
          example: NG
        account:
          type: object
          required:
            - accountNumber
            - sortCode
          properties:
            accountNumber:
              type: string
              description: Bank account number to enquire about
            sortCode:
              type: string
              description: Bank sort code (bank code)
    Success:
      type: object
      properties:
        status:
          type: string
          example: success
        message:
          type: string
          example: Operation completed successfully.
        data:
          type: object
          description: The payload of the successful response.
      required:
        - status
        - message
    AccountEnquiry:
      type: object
      properties:
        accountNumber:
          type: string
          example: '0690000032'
        accountName:
          type: string
          example: JOHN DOE
        bankName:
          type: string
          example: ACCESS BANK NIGERIA
        sortCode:
          type: string
          example: '044'
        currency:
          type: string
          example: NGN
        country:
          type: string
          example: NG
    PayoutFailedResponse:
      type: object
      properties:
        message:
          type: string
          description: A human-readable error message.
        status:
          type: string
          example: failed
      required:
        - message
        - status
  responses:
    PayoutUnauthorized:
      description: Unauthorized. The provided API key is invalid or missing.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PayoutFailedResponse'
          example:
            message: Invalid API key
            status: failed
    PayoutForbidden:
      description: >-
        Forbidden. The request is not allowed because the source IP is not
        whitelisted.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PayoutFailedResponse'
          example:
            message: 'Access denied: IP address not whitelisted'
            status: failed
    EnquiryAccountNotFound:
      description: Not Found. The specified bank account could not be found or resolved.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PayoutFailedResponse'
          example:
            message: Account not found
            status: failed
    EnquiryValidationFailed:
      description: Unprocessable Entity. The account details are invalid.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/PayoutFailedResponse'
          example:
            message: Account validation failed
            status: failed
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````