> ## 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 Billers by Category

> Retrieve all merchant billers belonging to a specific category (e.g. Educational Institutions, Government MDAs, Utilities).

Retrieve all registered billers in a specific industry category.

### Popular Category IDs

* `6`: **Educational Institutions** (University of Ibadan, UNILAG, FUTO, Federal Polytechnics)
* `7`: **Government Payments** (CAC, FAAN, EFCC, State Governments)
* `3`: **Electricity / Utilities** (AEDC, Eko Electric, IBEDC, EEDC)
* `1`: **Telecommunications** (MTN, Airtel, Glo, 9mobile)

### 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"
    }
  ]
}
```


## 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.