Manage sub-entity balances
Beta

Last updated: March 25, 2026

You can get the balances and reserve rules for your sub-entities using the API.

You can view the balances your sub-entities hold with Checkout.com.

Call the Retrieve entity balances endpoint, and provide the sub-entity ID as the {id} path parameter.

get

https://balances.checkout.com/balances/{id}


1{
2  "data": [
3    {
4      "descriptor": "Revenue Account 1",
5      "holding_currency": "USD",
6      "balances": {
7        "available": 50000,
8        "collateral": 6000,
9        "operational": 7000,
10        "payable": 2700,
11        "pending": 23000
12      }
13    }
14  ]
15}

Checkout.com sets reserve rules to hold a percentage of a sub-entity's captured funds. We use this reserve to cover chargebacks, refunds, and other costs Checkout.com may be liable for.

Call the Get reserve rule details endpoint, and provide the:

Sub-entity ID as the {entityId} path parameter
Reserve rule ID as the {id} path parameter

get

https://balances.checkout.com/balances/{entityId}/reserve-rules/{id}


1{
2  "id": "rsv_qn4nis4k3ykpzzu7cvtuvhqqga",
3  "type": "rolling",
4  "valid_from": "2026-01-01T13:33:00.000Z",
5  "rolling": {
6    "percentage": 10,
7    "holding_duration": {
8      "weeks": 2
9    }
10  }
11}

Manage sub-entity balances
Beta

Retrieve sub-entity balances

Response example

Get reserve rule details

Response example