BBPS & Utility · BBPS Bill Services

BBPS Bill Fetch

Fetch outstanding bill details, customer name, bill amount and due date for a biller.

POST request

URL: https://api.payorbit.in/api/v1/bbps/bill-fetch

Body

{
    "canumber": "100123456",
    "operator": "BSE000001DEL01"
}

Include a valid Bearer token with every request

Success response

{
    "raw": {
        "status": true,
        "message": "Bill Fetched Successfully",
        "response_code": 1
    },
    "name": "JOHN DOE",
    "amount": 1450,
    "status": "success",
    "due_date": "2026-10-15",
    "bill_number": "BILL-8923412",
    "bill_period": "SEP-2026"
}

Failure response

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

Overview

Fetch live bill information for a consumer number from the biller operator via InsPay BBPS.

Header: Authorization: Bearer {token}
Returns consumer name, outstanding amount, bill number and due date.

Body

application/json required

Schema

{
    "type": "object",
    "required": [
        "operator",
        "canumber"
    ],
    "properties": {
        "ad1": {
            "type": "string",
            "description": "Optional additional parameter 1"
        },
        "ad2": {
            "type": "string",
            "description": "Optional additional parameter 2"
        },
        "canumber": {
            "type": "string",
            "description": "Consumer number / CA number / Account number"
        },
        "operator": {
            "type": "string",
            "description": "Biller ID or operator code (e.g. BSE000001DEL01)"
        }
    }
}

Example

{
    "canumber": "100123456",
    "operator": "BSE000001DEL01"
}

Responses

200 · application/json

Successful operation

Example

{
    "raw": {
        "status": true,
        "message": "Bill Fetched Successfully",
        "response_code": 1
    },
    "name": "JOHN DOE",
    "amount": 1450,
    "status": "success",
    "due_date": "2026-10-15",
    "bill_number": "BILL-8923412",
    "bill_period": "SEP-2026"
}