Get Bills of Billing Account Action

Retrieve bills for a billing account from an external billing system, with optional date range or count filtering.

This action is available in API version 60.0 and later.

Special Access Rules

The Get Bills of Billing Account action is available in Enterprise and Unlimited Editions with Energy and Utilities Cloud.

Supported REST HTTP Methods

URI: /services/data/v60.0/actions/standard/getBillsOfBillingAccount

Formats: JSON, XML

HTTP Methods: POST

Authentication: Authorization: Bearer TOKEN

Where TOKEN is a variable.

Inputs

Input	Type	Description
`billingAccountId`	string	Required. ID of the billing account whose bills are retrieved.
`numberOfBills`	int	Optional. Maximum number of bills to retrieve.
`startDate`	date	Optional. Retrieves bills dated on or after this date.
`endDate`	date	Optional. Retrieves bills dated on or before this date.

Outputs

Output	Type	Description
`billsOfBillingAccount`	string array[]	List of JSON strings, each containing data for one bill retrieved from the external billing system. Maximum of 50 items.

Example

POST

This sample request is for the Get Bills of Billing Account action.

1{
2  "inputs": [
3    {
4      "billingAccountId": "15ixx0000004CjrAAE",
5      "numberOfBills": 2
6    }
7  ]
8}

This sample response is for the Get Bills of Billing Account action.

1[
2  {
3    "actionName": "getBillsOfBillingAccount",
4    "errors": null,
5    "invocationId": null,
6    "isSuccess": true,
7    "outputValues": {
8      "billsOfBillingAccount": [
9        "{\"billId\":\"B123\",\"billDate\":\"2026-05-01\",\"amount\":145.50,\"status\":\"Paid\"}",
10        "{\"billId\":\"B124\",\"billDate\":\"2026-06-01\",\"amount\":152.30,\"status\":\"Due\"}"
11      ]
12    },
13    "sortOrder": -1,
14    "version": 1
15  }
16]