Batch APIs

Post /api/v3/batch

Operation: OpenBatchV3 Permissions: BillsAndBatches (Create)


Get /api/v3/batch

Operation: GetBatchesV3 Permissions: BillsAndBatches (View) Paginated


Get /api/v3/batch/{batchId}

Operation: GetBatchV3 Permissions: BillsAndBatches (View)


Put /api/v3/batch/{batchId}

Operation: EditBatchV3 Permissions: BillsAndBatches (Create)


Delete /api/v3/batch/{batchId}

Operation: DeleteBatchV3 Permissions: BillsAndBatches (Delete)


Put /api/v3/batch/close/{batchId}

Operation: CloseBatchV3 Permissions: BillsAndBatches (Create)


Put /api/v202206/batch/{batchId}/status

Operation: UpdateBatchStatusV202206

Update the status of a batch.
Requesting user must have BillAndBatches Create to update their own batch or to open another user’s pending batch.
User must have BillsAndBatches Manage to update another user’s batch to closed or pending.
If opening another user’s batch, the requesting user’s open batch (if any) will be set to Pending status.
See ‘Batch Statuses’ section below for more information.


Put /api/v202104/batch/{batchId}/distributeAccountCharges

Operation: DistributeAccountChargesToMetersForBillsInBatchV202104 Permissions: BillsAndBatches (Edit)

For each bill in the provided batch which has account-level charges, distribute these account charges amongst the meters on the bill.
This is done proportionally by meter use or cost, depending on the split basis.
Maximum of 10000 bills can be processed at one time.