curl -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET https://api.razorpay.com/v1/bill_payments/billers/categories
{
"categories": [
"insurance",
"loan",
"education",
"electricity"
]
}
{
"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"
}
}
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 -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET https://api.razorpay.com/v1/bill_payments/billers/categories
{
"categories": [
"insurance",
"loan",
"education",
"electricity"
]
}
{
"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"
}
}
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 -u [YOUR_KEY_ID]:[YOUR_KEY_SECRET] \
-X GET https://api.razorpay.com/v1/bill_payments/billers/categories
{
"categories": [
"insurance",
"loan",
"education",
"electricity"
]
}
{
"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"
}
}
Response Parameters
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.
Unable to fetch biller categories.
Code:
400Unable 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.
The API <key/secret> provided is invalid.
Code:
401The 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.Last modified on October 8, 2026
Was this page helpful?