> ## 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, ticket 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
                    description: Human-readable confirmation of the operation result.
                    example: Biller categories fetched successfully
                  data:
                    type: array
                    description: >-
                      Alphabetically sorted list of active biller categories
                      available on the BBPS network.
                    items:
                      type: string
                    example:
                      - Broadband Postpaid
                      - Cable TV
                      - Clubs and Associations
                      - Credit Card
                      - DTH
                      - Donation
                      - Education
                      - Electricity
                      - Fastag
                      - Gas
                      - Hospital
                      - Hospital and Pathology
                      - Insurance
                      - LPG Gas
                      - Landline Postpaid
                      - Loan Repayment
                      - Mobile Postpaid
                      - Municipal Services
                      - Municipal Taxes
                      - Recurring Deposit
                      - Rental
                      - 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: Internal Server Error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/InternalServerErrorResponse'
components:
  schemas:
    UnauthorizedResponse:
      type: object
      properties:
        message:
          type: string
          description: Human-readable description of the authentication failure.
          example: authentication Failed
        code:
          type: string
          description: Machine-readable error code identifying the failure reason.
          example: request_failed
        type:
          type: string
          description: Category of the error, indicating the error class.
          example: authentication_error
    RateLimitResponse:
      type: object
      properties:
        message:
          type: string
          description: Human-readable description of the rate limit breach.
          example: Too many requests from IP. Check headers
        code:
          type: string
          description: Machine-readable error code identifying the failure reason.
          example: request_failed
        type:
          type: string
          description: Category of the error, indicating the error class.
          example: rate_limit_error
    InternalServerErrorResponse:
      type: object
      properties:
        message:
          type: string
          description: Human-readable description of the server-side error.
          example: internal Server Error
        code:
          type: string
          description: Machine-readable error code identifying the failure reason.
          example: internal_error
        type:
          type: string
          description: Category of the error, indicating the error class.
          example: api_error
  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).

````