Skip to main content

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

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

Example 2. 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)

Example 3. 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))

}

Example 4. 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);
});

URL query strings

Important

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.

In this section: