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

# Get All Billers

> Retrieve all registered merchant billers, institutions, universities, MDAs, and corporations across Nigeria.

Retrieve the complete catalog of registered merchant billers available on Remita.

### Response Fields

* `billerId`: Unique merchant ID (e.g. `S0000573002` for University of Ibadan, `SPECSELECTRICITY` for AEDC).
* `billerName`: Official institution / organization name.
* `billerShortName`: Short abbreviation or trading name.
* `billerLogoUrl`: Cloudinary-hosted brand logo URL.
* `countryCode`: Sovereign country currency code (`NGN`).

### Response Schema

```json theme={null}
{
  "status": "00",
  "message": "Approved or completed successfully",
  "data": [
    {
      "billerId": "S0000573002",
      "billerName": "UNIVERSITY OF IBADAN",
      "billerShortName": "UNIVERSITY OF IBADAN",
      "billerLogoUrl": "https://res.cloudinary.com/remita/image/upload/v1713520817/AU_REC_logos_-_2022-04-04T113109.892_xbopn8.png",
      "countryCode": "NGN"
    },
    {
      "billerId": "CAC",
      "billerName": "CORPORATE AFFAIRS COMMISSION",
      "billerShortName": "CAC",
      "billerLogoUrl": null,
      "countryCode": "NGN"
    }
  ]
}
```


## OpenAPI

````yaml openapi.json GET /bill-payment/biller/billers
openapi: 3.0.3
info:
  title: Handle Merchant Payment Gateway API
  description: >-
    Developer API specification for accepting cardless, instant
    Account-to-Account (A2A) payments via Handle.
  version: 1.0.0
  contact:
    name: Handle Developer Support
    email: support@handle.ng
    url: https://handle.ng
servers:
  - url: https://api-local.handle.ng/api/v1
    description: Local Development (SSL)
  - url: https://api.handle.ng/api/v1
    description: Production Live Gateway
security:
  - BearerAuth: []
paths:
  /bill-payment/biller/billers:
    get:
      tags:
        - VAS & Bill Payments
      summary: Get Institutional Billers
      description: >-
        Retrieve registered institutions, universities, teaching hospitals, and
        MDAs filtered by category.
      parameters:
        - name: categoryId
          in: query
          required: false
          description: >-
            Category ID (e.g. 6 for Education, 7 for Government, 8 for Taxes, 16
            for Hospitals)
          schema:
            type: string
            default: '6'
          example: '6'
        - name: page
          in: query
          required: false
          schema:
            type: integer
            default: 0
        - name: size
          in: query
          required: false
          schema:
            type: integer
            default: 20
      responses:
        '200':
          description: List of registered billers in category
          content:
            application/json:
              example:
                - billerId: S0000573002
                  billerName: University of Ibadan
                  billerShortName: UI
                  countryCode: NGN
                - billerId: SPECSELECTRICITY
                  billerName: ABUJA ELECTRICITY DISTRIBUTION COMPANY
                  countryCode: NGN
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Supply your secret API key (e.g. `sk_live_...` or `sk_test_...`) in the
        Authorization header.
      x-default: sk_test_handle_master_key

````

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