Operator List - OriginBills Docs

Retrieve the list of supported recharge operators (such as Prepaid Mobile, DTH, etc.) and their respective IDs.

Endpoint: /v1/recharge/operators
Method: GET
Authentication: Required (Basic Auth via Header or Query Parameter)

Query Parameters

Parameter	Type	Required	Description
`authorization`	string	Optional	Can be used to authenticate the request if the `Authorization` header is not present (e.g. `Basic <base64_credentials>`).

URL Example

GET https://api.originbills.in/v1/recharge/operators

Success Response (200 OK)

{
  "status": true,
  "statusCode": 200,
  "message": "Recharge operators list retrieved successfully.",
  "data": [
    {
      "id": 1,
      "name": "Jio Mobile",
      "status": "active"
    },
    {
      "id": 2,
      "name": "Airtel Mobile",
      "status": "active"
    },
    {
      "id": 3,
      "name": "Tata Play DTH",
      "status": "active"
    },
    {
      "id": 4,
      "name": "Vi Prepaid",
      "status": "inactive"
    }
  ]
}

Response Fields

Field	Type	Description
`status`	boolean	Indicates if the operation was successful.
`statusCode`	integer	HTTP response status code.
`message`	string	A descriptive message from the server.
`data`	array	List of operator objects.
`data[].id`	integer \| null	Unique identifier for the operator (to be passed as `operator_id` in transaction requests).
`data[].name`	string	Name of the mobile or DTH operator.
`data[].status`	string	Current status of the operator (`active` or `inactive`).

Error Responses

Unauthorized (401 Unauthorized)

Returned if the Authorization header/query parameter is invalid, missing, or empty.

{
  "status": false,
  "statusCode": 401,
  "message": "Unauthorized access."
}