---
title: "List balance history"
source_url: https://dev.digicert.com/certcentral-apis/services-api/finance/list-balance-history.html
api_method: GET
api_endpoint: "/services/v2/finance/balance-history"
api_url: "https://www.digicert.com/services/v2/finance/balance-history"
---

**GET** `https://www.digicert.com/services/v2/finance/balance-history`

Use this endpoint to list balance adjustment history for your account.

## Example requests and responses

**cURL**

```bash
curl -X GET \
  https://www.digicert.com/services/v2/finance/balance-history \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
```

**Python**

```python
import requests

url = "https://www.digicert.com/services/v2/finance/balance-history"

payload = ""
headers = {
    'X-DC-DEVKEY': "{{api_key}}",
    'Content-Type': "application/json"
    }

response = requests.request("GET", url, data=payload, headers=headers)

print(response.text)
```

**Go**

```go
package main

import (
	"fmt"
	"net/http"
	"io/ioutil"
)

func main() {

	url := "https://www.digicert.com/services/v2/finance/balance-history"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-DC-DEVKEY", "{{api_key}}")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := ioutil.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

**NodeJS**

```javascript
var request = require("request");

var options = { method: 'GET',
  url: 'https://www.digicert.com/services/v2/finance/balance-history',
  headers: 
   { 'Content-Type': 'application/json',
     'X-DC-DEVKEY': '{{api_key}}' } };

request(options, function (error, response, body) {
  if (error) throw new Error(error);

  console.log(body);
});
```


## 200 OK

```json
{
  "adjustments": [
    {
      "id": "5335328",
      "container": {
        "id": 123456,
        "name": "Example Company",
        "is_active": true
      },
      "debit": "750.00",
      "transaction_type": "Charge",
      "transaction_date": "2021-01-21 15:21:34",
      "balance_after": "8500.15",
      "currency": "USD"
    },
    {
      "id": "5533001",
      "container": {
        "id": 123456,
        "name": "Example Company",
        "is_active": true
      },
      "credit": "1000.00",
      "transaction_type": "Credit Card Deposit",
      "transaction_date": "2021-01-21 15:20:18",
      "balance_after": "9250.15",
      "expiration_date": "2022-01-21 00:00:00",
      "currency": "USD"
    },
  ],
  "page": {
    "total": 2,
    "limit": 1000,
    "offset": 0
  }
}
```

## Filters and URL query parameters

This endpoint supports filters, sorting, and pagination. For general information and examples of the syntax to use when applying filters and sorting results, see [Services API - Filters, sorting, and pagination parameters](https://dev.digicert.com/md/certcentral-apis/services-api.md#filters-sorting-and-pagination-parameters).

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Req/Opt</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>container_id</td>
<td>optional<sup>*</sup></td>
<td>int</td>
<td>ID of the container to get the balance history for.<br>*Note: Required if there is more than one division in your account.</td>
</tr>
<tr>
<td>filters[<code>{{property_name}}</code>]</td>
<td>optional</td>
<td>string</td>
<td>Filters results by the specified property. Replace <code>{{property_name}}</code> in your request with the property to use for filtering. This endpoint supports filtering by the following properties:<br><ul><li><code>filters[container_id]</code></li><li><code>filters[adjust_type]</code>: Filters by <a href="https://dev.digicert.com/md/certcentral-apis/services-api/finance/list-balance-history.md#transaction_type">transaction_type</a>. For <code>adjust_type</code> to <code>transaction_type</code> mapping, see <a href="https://dev.digicert.com/md/certcentral-apis/services-api/finance/list-balance-history.md#transaction-types">Transaction types</a>.</li><li><code>filters[transaction_date]</code></li><li><code>filters[expiration_date]</code></li></ul></td>
</tr>
<tr>
<td>sort</td>
<td>optional</td>
<td>string</td>
<td>Sorts results by the value of one or more properties.<br>By default, sorts results in ascending alphabetical order (0-9, A-Z). To sort in descending alphabetical order (9-0, Z-A), prefix the property name with a minus (<code>-</code>).<br>To sort by multiple properties, separate the name of each property with a comma. Sort hierarchy matches the order of properties in this list.<br>This endpoint supports sorting by the following properties:<br><ul><li><code>id</code></li><li><code>credit</code></li><li><code>debit</code></li><li><code>transaction_type</code></li><li><code>receipt_id</code></li><li><code>transaction_date</code></li><li><code>balance_after</code></li><li><code>order_id</code></li><li><code>expiration_date</code> Note: When sorting in ascending order by expiration_date, we return adjustments with no expiration_date first.</li></ul></td>
</tr>
<tr>
<td>offset</td>
<td>optional</td>
<td>int</td>
<td>Index of the first result to include in the response.</td>
</tr>
<tr>
<td>limit</td>
<td>optional</td>
<td>int</td>
<td>Total number of results to include in the response.</td>
</tr>
</tbody>
</table>

## Response parameters

<table class="params-table">
<thead>
<tr>
<th>Name</th>
<th>Type</th>
<th>Description</th>
</tr>
</thead>
<tbody>
<tr>
<td>adjustments</td>
<td>array</td>
<td>List of adjustments.</td>
</tr>
<tr>
<td>.. id</td>
<td>string</td>
<td>Adjustment ID.</td>
</tr>
<tr>
<td>.. container</td>
<td>object</td>
<td>Details about the container that initiated the adjustment.</td>
</tr>
<tr>
<td>.. .. id</td>
<td>int</td>
<td>Container ID.</td>
</tr>
<tr>
<td>.. .. name</td>
<td>string</td>
<td>Name of the container.</td>
</tr>
<tr>
<td>.. .. is_active</td>
<td>bool</td>
<td>Active status of the container.</td>
</tr>
<tr>
<td>.. credit .. debit</td>
<td>string</td>
<td>If credit, the amount that was deposited into the account. If debit, the amount that was withdrawn from the account.</td>
</tr>
<tr>
<td>.. transaction_type</td>
<td>string</td>
<td>Type of adjustment that took place.<br>Possible values: See transaction_type column in the Transaction types table below.</td>
</tr>
<tr>
<td>.. receipt_id</td>
<td>string</td>
<td>Receipt ID. Value of 0 is returned for all credit transactions.</td>
</tr>
<tr>
<td>.. transaction_date</td>
<td>string</td>
<td>Timestamp of the adjustment.<br>Format:
YYYY-MM-DD hh:mm:ss</td>
</tr>
<tr>
<td>.. balance_after</td>
<td>string</td>
<td>Account balance after adjustment took place.</td>
</tr>
<tr>
<td>.. expiration_date</td>
<td>string</td>
<td>For deposits, we return the date and time (UTC) the funds expire.<br>Format:YYYY-MM-DD hh:mm:ss Not returned for adjustments that debit your account balance.</td>
</tr>
<tr>
<td>.. note</td>
<td>string</td>
<td>Note about the adjustment.</td>
</tr>
<tr>
<td>.. currency</td>
<td>string</td>
<td>Currency unit for the adjustment.</td>
</tr>
<tr>
<td><a href="https://dev.digicert.com/md/certcentral-apis/services-api/structures.md#page-details-object">page</a></td>
<td>object</td>
<td>Details about results. Modified using URL query strings.</td>
</tr>
</tbody>
</table>

## Transaction types

<table>
<thead>
<tr>
<th>adjust_type</th>
<th>transaction_type</th>
</tr>
</thead>
<tbody>
<tr>
<td>1</td>
<td>Charge</td>
</tr>
<tr>
<td>4</td>
<td>Sale from Account Balance</td>
</tr>
<tr>
<td>8</td>
<td>Credit Card Deposit</td>
</tr>
<tr>
<td>9</td>
<td>Wire Deposit</td>
</tr>
<tr>
<td>11</td>
<td>Deposit from Check</td>
</tr>
<tr>
<td>12</td>
<td>Deposit from PO</td>
</tr>
<tr>
<td>13</td>
<td>Credit for Commission Payment</td>
</tr>
<tr>
<td>15</td>
<td>Purchase Order Payment</td>
</tr>
<tr>
<td>16</td>
<td>Additional Name Purchase</td>
</tr>
<tr>
<td>18</td>
<td>Credit for a revoked certificate</td>
</tr>
<tr>
<td>19</td>
<td>Transfer of funds to another unit in the account</td>
</tr>
<tr>
<td>20</td>
<td>Transfer of funds from another unit in the account</td>
</tr>
<tr>
<td>22</td>
<td>Charge for Subaccount Order</td>
</tr>
<tr>
<td>23</td>
<td>Refund for Subaccount Order</td>
</tr>
<tr>
<td>26</td>
<td>Refund</td>
</tr>
<tr>
<td>27</td>
<td>Account Funds Expiration</td>
</tr>
<tr>
<td>28</td>
<td>Charge for unit order</td>
</tr>
<tr>
<td>29</td>
<td>Refund for unit order</td>
</tr>
</tbody>
</table>