Docusign

Docusign Invoices API

The Invoices resource provides methods that allow you to manage the invoices for an account.

Documentation GitHub OpenAPI

Business capability

Invoicing & Statement Management BC-4250.30

Operations 6

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/accounts/{accountId}/billing_invoices List billing invoices · Docusign Get a List of Billing Invoices #

Ask an LLM

“Where can I see my DocuSign invoices for the past year?”

“Can I list invoices between two dates?”

Tell an agent

List billing invoices for account {account}.

Show invoices for account {account} from {from_date} to {to_date}.

GET /v2/accounts/{accountId}/billing_invoices/{invoiceId} Get a billing invoice · Docusign Retrieves a billing invoice #

Ask an LLM

“How do I get the details of one invoice?”

“Can I download a specific invoice as a PDF?”

Tell an agent

Get invoice {invoice} for account {account}.

Download the PDF of invoice {invoice} on account {account}.

GET /v2/accounts/{accountId}/billing_invoices_past_due List past-due invoices · Docusign Get a list of past due invoices #

Ask an LLM

“Do I have any overdue invoices on my account?”

“Can past-due invoices be paid through the REST API?”

Tell an agent

List past-due invoices for account {account}.

Show which invoices on account {account} are overdue.

GET /v2.1/accounts/{accountId}/billing_invoices Get a List of Billing Invoices #

GET /v2.1/accounts/{accountId}/billing_invoices/{invoiceId} Retrieves a billing invoice #

GET /v2.1/accounts/{accountId}/billing_invoices_past_due Get a list of past due invoices #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/docusign:docusign-invoices-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Docusign Invoices API
  termsOfService: https://www.docusign.com/company/terms-and-conditions/web
  version: '1.0'
  description: 'Operations tagged Invoices across 2 of this provider''s published API definitions: docusign-openapi-original.yml, docusign-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.docusign.net/restapi
tags:
- name: Invoices
  description: The Invoices resource provides methods that allow you to manage the invoices for an account.
paths:
  /v2/accounts/{accountId}/billing_invoices:
    get:
      tags:
      - Invoices
      summary: Docusign Get a List of Billing Invoices
      description: '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'
      operationId: BillingInvoices_GetBillingInvoices
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account id GUID.
        required: true
        schema:
          type: string
      - name: from_date
        in: query
        description: Specifies the date/time of the earliest invoice in the account to retrieve.
        schema:
          type: string
      - name: to_date
        in: query
        description: Specifies the date/time of the latest invoice in the account to retrieve.
        schema:
          type: string
      responses:
        '200':
          description: Successful response.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/billingInvoicesResponse'
        '400':
          description: Error encountered.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/errorDetails'
      deprecated: false
      x-ds-methodname: listInvoices
      x-ds-method: list
      x-ds-service: Billing
      x-ds-in-sdk: true
    servers:
    - url: https://www.docusign.net/restapi
  /v2/accounts/{accountId}/billing_invoices/{invoiceId}:
    get:
      tags:
      - Invoices
      summary: Docusign Retrieves a billing invoice
      description: 'Retrieves the specified invoice.


        ###### Note: If the `pdfAvailable` property in the response is set to *true*, you can download a PDF version of the invoice. To download the PDF, make the call again and change the value of the `Accept` property in the header to `Accept: application/pdf`.


        Privileges required: account administrator


        The response returns a list of charges and information about the charges. Quantities are usually shown as ''unlimited'' or an integer. Amounts are shown in the currency set for the account.


        **Response**

        The following table provides a description of the different `chargeName` property values. The information will grow as more chargeable items are added to the system.


        | chargeName | Description |

        | --- | --- |

        | id_check | ID Check Charge |

        | in_person_signing | In Person Signing charge |

        | envelopes Included | Sent Envelopes for the account |

        | age_verify | Age verification check |

        | ofac | OFAC Check |

        | id_confirm | ID confirmation check |

        | student_authentication | STAN PIN authentication check |

        | wet_sign_fax | Pages for returning signed documents by fax |

        | attachment_fax | Pages for returning attachments by fax |

        | phone_authentication | Phone authentication charge |

        | powerforms | PowerForm envelopes sent |

        | signer_payments | Payment processing charge |

        | outbound_fax | Send by fax charge |

        | bulk_recipient_envelopes | Bulk Recipient Envelopes sent |

        | sms_authentications | SMS authentication charge |

        | saml_authentications | SAML authentication charge |

        | express_signer_certificate | DocuSign Express Certificate charge |

        | personal_signer_certificate | Personal Signer Certificate charge |

        | safe_certificate | SAFE BioPharma Signer Certificate charge |

        | seats | Included active seats charge |

        | open_trust_certificate | OpenTrust Signer Certificate charge |'
      operationId: BillingInvoices_GetBillingInvoice
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account id GUID.
        required: true
        schema:
          type: string
      - name: invoiceId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/billingInvoice'
        '400':
          description: Error encountered.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/errorDetails'
      deprecated: false
      x-ds-methodname: getInvoice
      x-ds-method: get
      x-ds-service: Billing
      x-ds-in-sdk: true
    servers:
    - url: https://www.docusign.net/restapi
  /v2/accounts/{accountId}/billing_invoices_past_due:
    get:
      tags:
      - Invoices
      summary: Docusign Get a list of past due invoices
      description: 'Returns a list past due invoices for the account and notes if payment can be made through the REST API.


        Privileges Required: account administrator'
      operationId: BillingInvoices_GetBillingInvoicesPastDue
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account id GUID.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/billingInvoicesSummary'
        '400':
          description: Error encountered.
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/errorDetails'
      deprecated: false
      x-ds-methodname: listInvoicesPastDue
      x-ds-method: listPastDue
      x-ds-service: Billing
      x-ds-in-sdk: true
    servers:
    - url: https://www.docusign.net/restapi
  /v2.1/accounts/{accountId}/billing_invoices:
    parameters: []
    get:
      tags:
      - Invoices
      summary: Get a List of Billing Invoices
      description: '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'
      operationId: getV21AccountsByAccountIdBillingInvoices
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account ID GUID.
        required: true
        schema:
          type: string
      - name: from_date
        in: query
        description: Specifies the date/time of the earliest invoice in the account to retrieve.
        required: false
        schema:
          type: string
      - name: to_date
        in: query
        description: Specifies the date/time of the latest invoice in the account to retrieve.
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingInvoicesResponse_2'
        '400':
          description: Error encountered.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorDetails_2'
      deprecated: false
      x-ds-methodname: listInvoices
      x-ds-method: list
      x-ds-service: Billing
      x-ds-in-sdk: true
      x-operation-id-source: normalized
      x-operation-id-original: BillingInvoices_GetBillingInvoices
    servers:
    - url: https://www.docusign.net/restapi
  /v2.1/accounts/{accountId}/billing_invoices/{invoiceId}:
    parameters: []
    get:
      tags:
      - Invoices
      summary: Retrieves a billing invoice
      description: 'Retrieves the specified invoice.


        **Note:** If the `pdfAvailable` property in the response is set to *true*, you can download a PDF version of the invoice. To download the PDF, make the call again and change the value of the `Accept` property in the header to `Accept: application/pdf`.


        Privileges required: account administrator


        The response returns a list of charges and information about the charges. Quantities are usually shown as ''unlimited'' or an integer. Amounts are shown in the currency set for the account.


        **Response**

        The following table provides a description of the different `chargeName` property values. The information will grow as more chargeable items are added to the system.


        | chargeName | Description |

        | --- | --- |

        | id_check | ID Check Charge |

        | in_person_signing | In Person Signing charge |

        | envelopes Included | Sent Envelopes for the account |

        | age_verify | Age verification check |

        | ofac | OFAC Check |

        | id_confirm | ID confirmation check |

        | student_authentication | STAN PIN authentication check |

        | wet_sign_fax | Pages for returning signed documents by fax |

        | attachment_fax | Pages for returning attachments by fax |

        | phone_authentication | Phone authentication charge |

        | powerforms | PowerForm envelopes sent |

        | signer_payments | Payment processing charge |

        | outbound_fax | Send by fax charge |

        | bulk_recipient_envelopes | Bulk Recipient Envelopes sent |

        | sms_authentications | SMS authentication charge |

        | saml_authentications | SAML authentication charge |

        | express_signer_certificate | Docusign Express Certificate charge |

        | personal_signer_certificate | Personal Signer Certificate charge |

        | safe_certificate | SAFE BioPharma Signer Certificate charge |

        | seats | Included active seats charge |

        | open_trust_certificate | OpenTrust Signer Certificate charge |'
      operationId: getV21AccountsByAccountIdBillingInvoicesByInvoiceId
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account ID GUID.
        required: true
        schema:
          type: string
      - name: invoiceId
        in: path
        required: true
        description: The ID of the invoice.
        schema:
          type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingInvoice_2'
        '400':
          description: Error encountered.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorDetails_2'
      deprecated: false
      x-ds-methodname: getInvoice
      x-ds-method: get
      x-ds-service: Billing
      x-ds-in-sdk: true
      x-operation-id-source: normalized
      x-operation-id-original: BillingInvoices_GetBillingInvoice
    servers:
    - url: https://www.docusign.net/restapi
  /v2.1/accounts/{accountId}/billing_invoices_past_due:
    parameters: []
    get:
      tags:
      - Invoices
      summary: Get a list of past due invoices
      description: 'Returns a list past due invoices for the account and notes if payment can be made through the REST API.


        Privileges Required: account administrator'
      operationId: getV21AccountsByAccountIdBillingInvoicesPastDue
      parameters:
      - name: accountId
        in: path
        description: The external account number (int) or account ID GUID.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/billingInvoicesSummary_2'
        '400':
          description: Error encountered.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/errorDetails_2'
      deprecated: false
      x-ds-methodname: listInvoicesPastDue
      x-ds-method: listPastDue
      x-ds-service: Billing
      x-ds-in-sdk: true
      x-operation-id-source: normalized
      x-operation-id-original: BillingInvoices_GetBillingInvoicesPastDue
    servers:
    - url: https://www.docusign.net/restapi
components:
  schemas:
    billingInvoicesSummary:
      type: object
      properties:
        billingInvoices:
          type: array
          description: 'Reserved: TBD'
          items:
            $ref: '#/components/schemas/billingInvoice'
        pastDueBalance:
          type: string
          description: ''
        paymentAllowed:
          type: string
          description: ''
      description: ''
      x-ds-definition-name: billingInvoicesSummary
      x-ms-summary: ''
    billingInvoiceItem:
      type: object
      properties:
        chargeAmount:
          type: string
          description: 'Reserved: TBD'
        chargeName:
          type: string
          description: 'Reserved: TBD'
        invoiceItemId:
          type: string
          description: 'Reserved: TBD'
        quantity:
          type: string
          description: The quantity of envelopes to add to the account.
        unitPrice:
          type: string
          description: 'Reserved: TBD'
      description: Contains information about an item on a billing invoice.
      x-ds-definition-name: billingInvoiceItem
      x-ms-summary: Contains information about an item on a billing invoice.
    billingInvoicesResponse:
      type: object
      properties:
        billingInvoices:
          type: array
          description: 'Reserved: TBD'
          items:
            $ref: '#/components/schemas/billingInvoice'
        nextUri:
          type: string
          description: '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. '
        previousUri:
          type: string
          description: '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. '
      description: Defines a billing invoice response object.
      x-ds-definition-name: billingInvoicesResponse
      x-ms-summary: Defines a billing invoice response object.
    errorDetails:
      type: object
      properties:
        errorCode:
          type: string
          description: An error code associated with the error.
        message:
          type: string
          description: A short error message.
      description: This object describes errors that occur. It is only valid for responses, and ignored in requests.
      x-ds-definition-name: errorDetails
      x-ms-summary: This object describes errors that occur. It is only valid for responses, and ignored in requests.
    billingInvoice:
      type: object
      properties:
        amount:
          type: string
          description: The total amount of the purchase.
        balance:
          type: string
          description: 'Reserved: TBD'
        dueDate:
          type: string
          description: 'Reserved: TBD'
        invoiceId:
          type: string
          description: ''
        invoiceItems:
          type: array
          description: 'Reserved: TBD'
          items:
            $ref: '#/components/schemas/billingInvoiceItem'
        invoiceNumber:
          type: string
          description: 'Reserved: TBD'
        invoiceUri:
          type: string
          description: Contains a URI for an endpoint that you can use to retrieve invoice information.
        nonTaxableAmount:
          type: string
          description: ''
        pdfAvailable:
          type: string
          description: ''
        taxableAmount:
          type: string
          description: ''
      description: ''
      x-ds-definition-name: billingInvoice
      x-ms-summary: ''
    billingInvoicesSummary_2:
      type: object
      properties:
        accountBalance:
          description: ''
          type: string
        billingInvoices:
          description: Reserved for Docusign.
          type: array
          items:
            $ref: '#/components/schemas/billingInvoice_2'
        currencyCode:
          description: 'The [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) currency code.

            '
          type: string
        pastDueBalance:
          description: ''
          type: string
        paymentAllowed:
          description: ''
          type: string
      x-ds-definition-name: billingInvoicesSummary
      description: ''
      x-ms-summary: ''
    billingInvoiceItem_2:
      description: Contains information about an item on a billing invoice.
      type: object
      properties:
        chargeAmount:
          description: Reserved for Docusign.
          type: string
        chargeName:
          description: Reserved for Docusign.
          type: string
        invoiceItemId:
          description: Reserved for Docusign.
          type: string
        quantity:
          description: The quantity of envelopes to add to the account.
          type: string
        taxAmount:
          description: ''
          type: string
        taxExemptAmount:
          description: ''
          type: string
        unitPrice:
          description: Reserved for Docusign.
          type: string
      x-ds-definition-name: billingInvoiceItem
      x-ms-summary: Contains information about an item on a billing invoice.
    billingInvoicesResponse_2:
      description: Defines a billing invoice response object.
      type: object
      properties:
        billingInvoices:
          description: Reserved for Docusign.
          type: array
          items:
            $ref: '#/components/schemas/billingInvoice_2'
        nextUri:
          description: '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. '
          type: string
        previousUri:
          description: '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. '
          type: string
      x-ds-definition-name: billingInvoicesResponse
      x-ms-summary: Defines a billing invoice response object.
    errorDetails_2:
      description: This object describes errors that occur. It is only valid for responses and ignored in requests.
      type: object
      properties:
        errorCode:
          description: The code associated with the error condition.
          type: string
        message:
          description: A brief message describing the error condition.
          type: string
      x-ds-definition-name: errorDetails
      x-ms-summary: This object describes errors that occur. It is only valid for responses and ignored in requests.
    billingInvoice_2:
      description: Contains information about a billing invoice.
      type: object
      properties:
        amount:
          description: The total amount of the purchase.
          type: string
        balance:
          description: Reserved for Docusign.
          type: string
        dueDate:
          description: Reserved for Docusign.
          type: string
        invoiceId:
          description: Reserved for Docusign.
          type: string
        invoiceItems:
          description: Reserved for Docusign.
          type: array
          items:
            $ref: '#/components/schemas/billingInvoiceItem_2'
        invoiceNumber:
          description: Reserved for Docusign.
          type: string
        invoiceUri:
          description: Contains a URI for an endpoint that you can use to retrieve invoice information.
          type: string
        nonTaxableAmount:
          description: ''
          type: string
        pdfAvailable:
          description: ''
          type: string
        taxableAmount:
          description: ''
          type: string
      x-ds-definition-name: billingInvoice
      x-ms-summary: Contains information about a billing invoice.
x-refined-from:
- docusign-openapi-original.yml
- docusign-openapi.json
x-ds-categories:
- name: UserManagement
  summary: Methods to manage users in an account.
  description: Methods to manage users in an account.
- name: BulkOperations
  summary: Methods to import and export users and accounts.
  description: Methods to import and export users and accounts.
- name: IdentityProviders
  summary: Methods to get a list of identity providers.
  description: Methods to get a list of identity providers.
- name: ReservedDomains
  summary: Methods to get a list of reserved domains.
  description: Methods to get a list of reserved domains.
- name: Organization
  summary: Methods for working with organizations.
  description: Methods for working with organizations.
x-original-swagger-version: '2.0'

Docusign Invoices API

Operations 6

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification