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

# Fetch Biller Categories

> Use this API to fetch the list of all active biller categories available on the BBPS network. Agent Institutions can use this to populate category selection in their UI. Since this data changes infrequently, it is recommended to fetch and cache it at predefined intervals instead of calling the API on every user request.




## OpenAPI

````yaml /openapi/bbps/bbps-cou.yaml get /bbps/cou/v1/billers/categories
openapi: 3.0.3
info:
  title: BBPS for Customers (Customer Operating Unit)
  version: 1.0.0
  description: >
    APIs for Agent Institutions to integrate with the Bharat Bill Payment System
    (BBPS) as a Customer Operating Unit (COU). These APIs enable bill discovery,
    bill fetch, bill payment, complaint management, and wallet operations.
servers:
  - url: https://sandbox.cashfree.com
    description: Sandbox (Testing) environment.
  - url: https://api.cashfree.com
    description: Production environment.
security:
  - XClientID: []
    XClientSecret: []
paths:
  /bbps/cou/v1/billers/categories:
    get:
      tags:
        - Billers
      summary: Fetch Biller Categories
      description: >
        Use this API to fetch the list of all active biller categories available
        on the BBPS network. Agent Institutions can use this to populate
        category selection in their UI. Since this data changes infrequently, it
        is recommended to fetch and cache it at predefined intervals instead of
        calling the API on every user request.
      operationId: fetchBillerCategories
      responses:
        '200':
          description: >-
            Success response for fetching all active biller categories available
            on the BBPS network.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    description: Always "OK" on success.
                    example: OK
                  message:
                    type: string
                    example: Biller categories fetched successfully
                  data:
                    type: array
                    description: Alphabetically sorted list of biller category codes.
                    items:
                      type: string
                    example:
                      - BROADBAND_POSTPAID
                      - CABLE_TV
                      - CLUBS_AND_ASSOCIATIONS
                      - CREDIT_CARD
                      - DTH
                      - EDUCATION
                      - ELECTRICITY
                      - FASTAG
                      - GAS
                      - HOSPITAL
                      - INSURANCE
                      - LOAN_REPAYMENT
                      - MOBILE_POSTPAID
                      - SUBSCRIPTION
                      - WATER
        '401':
          description: Authentication Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UnauthorizedResponse'
        '429':
          description: Rate Limit Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RateLimitResponse'
        '500':
          description: API related Error.
components:
  schemas:
    UnauthorizedResponse:
      type: object
      properties:
        message:
          type: string
          example: Unauthorized
    RateLimitResponse:
      type: object
      properties:
        message:
          type: string
          example: too_many_requests_per_ip
  securitySchemes:
    XClientID:
      type: apiKey
      in: header
      name: x-client-id
      description: >-
        Your unique client identifier issued by Cashfree. You can find this in
        your [Merchant
        Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys).
    XClientSecret:
      type: apiKey
      in: header
      name: x-client-secret
      description: >-
        Your unique client secret issued by Cashfree. Keep this confidential and
        never expose it in client-side code. You can find this in your [Merchant
        Dashboard](https://merchant.cashfree.com/verificationsuite/developers/api-keys).

````