残高履歴を一覧表示する

GET

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

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

cURL

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

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)

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

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

{
  "adjustments": [
    {
      "id": "5",
      "container": {
        "id": 11223,
        "name": "Example Division",
        "is_active": true
      },
      "credit": "195.00",
      "transaction_type": "Credit",
      "receipt_id": "0",
      "transaction_date": "2018-10-18 08:47:53",
      "balance_after": "441.00",
      "note": "Payment for invoice #100001"
    },
    {
      "id": "4",
      "container": {
        "id": 11223,
        "name": "Example Division",
        "is_active": true
      },
      "credit": "98.00",
      "transaction_type": "Credit",
      "receipt_id": "0",
      "transaction_date": "2018-10-18 08:47:53",
      "balance_after": "246.00",
      "note": "Payment for invoice #100006"
    },
    {
      "id": "3",
      "container": {
        "id": 11223,
        "name": "Example Division",
        "is_active": true
      },
      "debit": "295.00",
      "transaction_type": "Sale from Account Balance",
      "receipt_id": "121214",
      "transaction_date": "2018-09-04 12:02:39",
      "balance_after": "148.00",
      "order_id": "12346",
      "note": "Auto-debit: enterprise order from account balance"
    },
    {
      "id": "2",
      "container": {
        "id": 11223,
        "name": "Example Division",
        "is_active": true
      },
      "debit": "157.00",
      "transaction_type": "Sale from Account Balance",
      "receipt_id": "121213",
      "transaction_date": "2018-09-04 12:02:06",
      "balance_after": "443.00",
      "order_id": "12345",
      "note": "Auto-debit: enterprise order from account balance"
    },
    {
      "id": "1",
      "container": {
        "id": 11223,
        "name": "Example Division",
        "is_active": true
      },
      "credit": "600.00",
      "transaction_type": "Credit",
      "receipt_id": "0",
      "transaction_date": "2018-08-15 09:21:53",
      "balance_after": "600.00",
      "note": "Initial deposit for account."
    },
  ],
  "page": {
    "total": 4,
    "limit": 1000,
    "offset": 0
  }
}

URL query strings

Name	Req/Opt	Type	Description
offset	optional	int	Start list at the specified number for pagination.
limit	optional	int	Truncate list to the specified number for pagination.

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

Response parameters

Name	Type	Description
adjustments	array	List of adjustments.
.. id	string	Adjustment ID.
.. container	object	Details about the container that initiated the adjustment.
.. .. id	int	Container ID.
.. .. name	string	Name of the container.
.. .. is_active	bool	Active status of the container.
.. credit .. debit	string	If credit, the amount that was deposited into the account. If debit, the amount that was withdrawn from the account.
.. transaction_type	string	Type of adjustment that took place. Possible values: `Credit`, `Sale from Account Balance`
.. receipt_id	string	Receipt ID. Value of `0` is returned for all credit transactions.
.. transaction_date	string	Timestamp of the adjustment. Format: `yyyy-MM-dd HH:mm:ss`
.. balance_after	string	Account balance after adjustment took place.
.. note	string	Note about the adjustment.
page	object	Details about results. Modified using URL query strings.

URL query strings

Response parameters

案内