> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay-881012b3.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch Biller Categories | BBPS API | Razorpay

> Retrieve all available biller categories on the BBPS platform using Razorpay's Bill Payments API.

<div style={{display:"flex",flexWrap:"wrap",alignItems:"center",gap:"0.35rem 0.9rem",border:"1px solid rgba(128,128,128,0.28)",borderRadius:"0.5rem",padding:"0.45rem 0.75rem",margin:"0 0 1.25rem",fontSize:"0.875rem"}}>
  <span style={{fontWeight:600}}>Available in</span>
  <span>🇮🇳 India</span>
</div>

Use this endpoint to retrieve all available biller categories on the Bharat Bill Payment System (BBPS). Categories include `electricity`, `water`, `gas`, `broadband`, `insurance` and more. Use any value returned in the `categories` array as the `category` query parameter when calling the [Fetch Billers](/docs/api/bills/bill-payments/fetch-billers) API.

<RequestExample>
  ```bash Curl theme={null}
  curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
  -X GET https://api.razorpay.com/v1/bill_payments/billers/categories
  ```
</RequestExample>

<ResponseExample>
  ```json Success theme={null}
  {
    "categories": [
      "insurance",
      "loan",
      "education",
      "electricity"
    ]
  }
  ```

  ```json Failure theme={null}
  {
    "error": {
      "code": "BAD_REQUEST_ERROR",
      "description": "Unable to fetch biller categories at this time. Retry after some time.",
      "source": "internal",
      "step": "category_fetch",
      "reason": "internal_server_error"
    }
  }
  ```
</ResponseExample>

## Response Parameters

<ResponseField name="categories" type="array" required>
  Array of biller categories as per NPCI MDM. Each element is a `string`. Pass any value as the `category` query parameter when calling the [Fetch Billers](/docs/api/bills/bill-payments/fetch-billers) API. For example, `insurance`, `loan`, `education`, `electricity`.
</ResponseField>

## Errors

<AccordionGroup>
  <Accordion title="Unable to fetch biller categories.">
    **Code:** `400`

    Unable to fetch biller categories at this time. Retry after some time.

    **Solution:** Retry the request after a short interval. If the issue persists, contact Razorpay support.
  </Accordion>

  <Accordion
    title="The API `<key/secret>
` provided is invalid."
  >
    **Code:** `401`

    The API credentials passed in the request differ from the ones generated on the Dashboard.

    **Solution:** Ensure your API key and secret are correct and active. Do not include extra whitespace around the credentials.
  </Accordion>
</AccordionGroup>