> ## 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 Institutional Categories

> Retrieve all merchant and institutional collection categories (Universities, Government MDAs, Taxes, Hospitals, Utilities, etc.).

Retrieve the full list of biller categories available for merchant collections and RRR generation on the Remita SystemSpecs gateway.

### Categories Overview

| Category ID | Name | Description |
| :- | :- | :- |
| `6` | Educational Institutions | Federal & State Universities, Polytechnics, Colleges of Education |
| `7` | Government Payments | Federal Ministries, Departments & Agencies (MDAs), State Govts |
| `8` | Taxes & Inland Revenue | FIRS, State Internal Revenue Services, Custom duties |
| `16` | Hospitals | University Teaching Hospitals, Federal Medical Centres |
| `3` | Utilities | Electricity Distribution Companies (DisCos), Water boards |
| `10` | Credit and Loans | Microfinance and lending institutions |
| `11` | Associations & Societies | Professional bodies (COREN, NBA, ICAN) |
| `12` | Religious Institutions | Churches, Mosques, Missions |
| `13` | Insurance | Insurance firms and HMO providers |
| `17` | Micro Pensions | Micro pension fund administrators |
| `999` | Invoice Category | Direct merchant invoice payments |

### Response Schema

```json theme={null}
{
  "status": "00",
  "message": "Approved or completed successfully",
  "data": [
    {
      "categoryId": "6",
      "categoryName": "Educational Institutions",
      "categoryDescription": "Educational Institutions"
    },
    {
      "categoryId": "7",
      "categoryName": "Government Payments",
      "categoryDescription": "Government Payments"
    },
    {
      "categoryId": "8",
      "categoryName": "Taxes, Internal and Inland Revenue",
      "categoryDescription": "Taxes, Internal and Inland Revenue"
    }
  ]
}
```


## OpenAPI

````yaml openapi.json GET /bill-payment/biller/categories
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/categories:
    get:
      tags:
        - VAS & Bill Payments
      summary: Get Institutional Biller Categories
      description: >-
        Retrieve all merchant and institutional collection categories
        (Universities, Government MDAs, Taxes, Hospitals, Utilities, etc.).
      parameters:
        - 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 institutional biller categories
          content:
            application/json:
              example:
                - categoryId: '6'
                  categoryName: Educational Institutions
                  categoryDescription: Educational Institutions
                - categoryId: '7'
                  categoryName: Government Payments
                  categoryDescription: Government Payments
                - categoryId: '8'
                  categoryName: Taxes, Internal and Inland Revenue
                  categoryDescription: Taxes, Internal and Inland Revenue
                - categoryId: '16'
                  categoryName: Hospitals
                  categoryDescription: Hospitals
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.