Fetch Biller Categories | BBPS API | Razorpay

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

GET /v1/bill_payments/billers/categories

Curl

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET https://api.razorpay.com/v1/bill_payments/billers/categories

Success

{
  "categories": [
    "insurance",
    "loan",
    "education",
    "electricity"
  ]
}

Available in🇮🇳 India

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

Curl

curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET https://api.razorpay.com/v1/bill_payments/billers/categories

Success

{
  "categories": [
    "insurance",
    "loan",
    "education",
    "electricity"
  ]
}

Response Parameters

categories · 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 API. For example, insurance, loan, education, electricity.

Errors

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.

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.