List billing invoices

GET

/v2.1/accounts/:accountId/billing_invoices

GET

/restapi/v2.1/accounts/:accountId/billing_invoices

curl https://demo.docusign.net/restapi/v2.1/accounts/ACCOUNT_ID/billing_invoices \
     -H "Authorization: Bearer <apiKey>"

{
  "billingInvoices": [
    {
      "amount": "sample string 1",
      "balance": "sample string 2",
      "dueDate": "sample string 3",
      "invoiceId": "sample string 4",
      "invoiceItems": [
        {
          "chargeAmount": "sample string 1",
          "chargeName": "sample string 2",
          "invoiceItemId": "sample string 3",
          "quantity": "sample string 4",
          "taxAmount": "sample string 5",
          "taxExemptAmount": "sample string 6",
          "unitPrice": "sample string 7"
        }
      ],
      "invoiceNumber": "sample string 5",
      "invoiceUri": "sample string 6",
      "nonTaxableAmount": "sample string 7",
      "pdfAvailable": "sample string 8",
      "taxableAmount": "sample string 9"
    }
  ],
  "nextUri": "sample string 1",
  "previousUri": "sample string 2"
}

Retrieves a list of invoices for the account. If the from date or to date queries are not specified, the response returns invoices for the last 365 days.

Privileges required: account administrator

Authentication

AuthorizationBearer

OAuth 2.0 access token (JWT or auth-code grant). Sent as Authorization: Bearer <token> on every request except GET /v2.1 and GET /service_information, which are public discovery endpoints.

Path parameters

accountIdstringRequired

The external account number (int) or account ID Guid.

Query parameters

from_datestringOptional

Specifies the date/time of the earliest invoice in the account to retrieve.

to_datestringOptional

Specifies the date/time of the latest invoice in the account to retrieve.

Response

Successful response.

billingInvoiceslist of objectsOptional

Reserved for Docusign.

nextUristringOptional

The URI for the next chunk of records based on the search request. It is null if this is the last set of results for the search.

previousUristringOptional

The URI for the prior chunk of records based on the search request. It is null if this is the first set of results for the search.

Errors

400

Bad Request Error