BBPS & Utility · BBPS Bill Services

Get BBPS Billers by Category

Retrieve billers under a specified category along with required input field schemas.

GET request

URL: https://api.payorbit.in/api/v1/bbps/billers

Include a valid Bearer token with every request

Success response

{
    "status": "success",
    "billers": [
        {
            "id": 101,
            "code": "BSE000001DEL01",
            "name": "BSES Rajdhani Power Limited",
            "fields": [
                {
                    "name": "CA Number",
                    "type": "numeric",
                    "param": "canumber",
                    "max_length": 9,
                    "min_length": 9
                }
            ],
            "fetch_requirement": "mandatory"
        }
    ],
    "category": {
        "id": 1,
        "name": "Electricity",
        "slug": "electricity"
    }
}

Failure response

{
    "status": "error",
    "message": "Request failed. Check credentials, wallet balance, or validation errors."
}

Overview

Retrieve all billers/operators under a given category slug or ID. Returns dynamic form schemas (CA number, Consumer ID, etc.) for UI rendering.

Query params: ?category=electricity or ?category_id=1
Header: Authorization: Bearer {token}

Responses

200 · application/json

Successful operation

Example

{
    "status": "success",
    "billers": [
        {
            "id": 101,
            "code": "BSE000001DEL01",
            "name": "BSES Rajdhani Power Limited",
            "fields": [
                {
                    "name": "CA Number",
                    "type": "numeric",
                    "param": "canumber",
                    "max_length": 9,
                    "min_length": 9
                }
            ],
            "fetch_requirement": "mandatory"
        }
    ],
    "category": {
        "id": 1,
        "name": "Electricity",
        "slug": "electricity"
    }
}