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

# Nigerian Name Enquiry

> Query the account name associated with a Nigerian bank account number. This uses the NIP (Nigerian Interbank Payment) system.

Query the account name associated with a Nigerian bank account number. This uses the NIP (Nigerian Interbank Payment) system to verify account details.

## Overview

This endpoint allows you to verify Nigerian bank account details by querying the account name associated with an account number. This is useful for validating recipient information before sending payments.

<Note>
  This endpoint is specific to Nigerian bank accounts and uses the NIP system. The account number and bank code must be valid Nigerian banking details.
</Note>

## Query Parameters

<ParamField query="account_number" type="string" required>
  Nigerian bank account number to query
</ParamField>

<ParamField query="bankcode" type="string" required>
  Bank code for the account's bank (e.g., "120001" for 9 Payment Service Bank)
</ParamField>

## Response

<ResponseField name="data" type="object">
  Account verification response containing:

  * `account_bank`: Bank name
  * `account_bank_code`: Bank code
  * `account_name`: Account holder name
  * `account_number`: Account number (verified)
</ResponseField>

<Warning>
  Always verify account names match before processing payments to prevent sending funds to incorrect recipients.
</Warning>


## OpenAPI

````yaml GET /utils/nigerian-name-enquiry
openapi: 3.0.0
info:
  title: Pooler Developer API
  description: >-
    Comprehensive API documentation for Pooler payment and financial services
    platform
  version: 1.0.0
servers:
  - url: https://api.usepooler.com
    description: Production server
  - url: https://sandbox.usepooler.com
    description: Sandbox server
security:
  - bearerAuth: []
paths:
  /utils/nigerian-name-enquiry:
    get:
      tags:
        - Utilities
      summary: Nigerian Name Enquiry
      description: >-
        Query the account name associated with a Nigerian bank account number.
        This uses the NIP (Nigerian Interbank Payment) system.
      operationId: nigerianNameEnquiry
      parameters:
        - name: account_number
          in: query
          required: true
          description: Nigerian bank account number
          schema:
            type: string
        - name: bankcode
          in: query
          required: true
          description: Bank code for the account's bank
          schema:
            type: string
      responses:
        '200':
          description: Account name retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NameEnquiryResponse'
components:
  schemas:
    NameEnquiryResponse:
      type: object
      properties:
        success:
          type: boolean
        message:
          type: string
        stan:
          type: string
          format: uuid
        data:
          $ref: '#/components/schemas/NameEnquiryData'
    NameEnquiryData:
      type: object
      properties:
        account_bank:
          type: string
        account_bank_code:
          type: string
        account_name:
          type: string
        account_number:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Bearer token authentication. Include your API key in the Authorization
        header as: Bearer {your_api_key}

````