Note: This release is in preview. Features described here don’t become generally available until the latest general availability date that Salesforce announces for this release. Before then, and where features are noted as beta, pilot, or developer preview, we can’t guarantee general availability within any particular time frame or at all. Make your purchase decisions only on the basis of generally available products and features.

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

Inputs

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

Outputs

Output	Details
billsOfBillingAccount	Type string array[] Description 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]

Energy and Utilities Cloud Developer Guide