View balance

GET
https://www.digicert.com/services/v2/finance/balance

Use this endpoint to view the current balance of your account.

Example requests and responses

cURL
curl -X GET \
  https://www.digicert.com/services/v2/finance/balance \
  -H 'Content-Type: application/json' \
  -H 'X-DC-DEVKEY: {{api_key}}'
Python
import requests

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

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

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

print(response.text)
Go
package main

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

func main() {

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

	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
var request = require("request");

var options = { method: 'GET',
  url: 'https://www.digicert.com/services/v2/finance/balance',
  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 (Negative balance limit)
{
    "balance": "454.00",
    "currency": "USD",
    "unpaid_invoice_balance": "0.00",
    "negative_balance_limit": "2000.00",
    "used_credit_from_other_containers": "0.00",
    "total_available_funds": "2454.00"
}
200 (Unlimited negative balance)
{
    "balance": "-1000.70",
    "currency": "USD",
    "unpaid_invoice_balance": "0.00",
    "used_credit_from_other_containers": "0.00",
    "unlimited_negative_balance": true
}

URL query strings

The container_id URL query string is required if your account contains more than one division.

Name Req/Opt Type Description
container_id optional int Filter results to the specified container.

Response parameters

Name Type Description
balance string Current account balance.
currency string Currency code for monetary values in this response.
Possible values: See Glossary - DigiCert currencies
unpaid_invoice_balance string Amount owed for unpaid invoices.
negative_balance_limit string Amount the account balance can go into the negative.
Not returned if unlimited_negative_balance is true.
total_available_funds string Total funds available for future purchases charged to the account balance. Calculated as balance + negative_balance_limit - unpaid_invoice_balance - used_credit_from_other_containers.
Not returned if unlimited_negative_balance is true.
used_credit_from_other_containers string Total amount owed by other divisions in the account, for accounts with separate division funds enabled.
unlimited_negative_balance boolean If true, the account has no negative balance limit.
Not returned if false.