# `DocuSign.Api.Invoices`
[🔗](https://github.com/neilberkman/docusign_elixir/blob/v3.4.0/lib/docusign/api/invoices.ex#L5)

API calls for all endpoints tagged `Invoices`.

# `billing_invoices_get_billing_invoice`

```elixir
@spec billing_invoices_get_billing_invoice(
  DocuSign.Connection.t(),
  String.t(),
  String.t(),
  keyword()
) ::
  {:ok, DocuSign.Model.BillingInvoice.t()} | {:error, Req.Response.t()}
```

Retrieves a billing invoice.
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 |

### Parameters

- `connection` (DocuSign.Connection): Connection to server
- `account_id` (String.t): The external account number (int) or account ID GUID.
- `invoice_id` (String.t): The ID of the invoice.
- `opts` (keyword): Optional parameters

### Returns

- `{:ok, DocuSign.Model.BillingInvoice.t}` on success
- `{:error, Req.Response.t}` on failure

# `billing_invoices_get_billing_invoices`

```elixir
@spec billing_invoices_get_billing_invoices(
  DocuSign.Connection.t(),
  String.t(),
  keyword()
) ::
  {:ok, DocuSign.Model.BillingInvoicesResponse.t()} | {:error, Req.Response.t()}
```

Get a List of Billing Invoices
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 

### Parameters

- `connection` (DocuSign.Connection): Connection to server
- `account_id` (String.t): The external account number (int) or account ID GUID.
- `opts` (keyword): Optional parameters
  - `:from_date` (String.t): Specifies the date/time of the earliest invoice in the account to retrieve.
  - `:to_date` (String.t): Specifies the date/time of the latest invoice in the account to retrieve.

### Returns

- `{:ok, DocuSign.Model.BillingInvoicesResponse.t}` on success
- `{:error, Req.Response.t}` on failure

# `billing_invoices_get_billing_invoices_past_due`

```elixir
@spec billing_invoices_get_billing_invoices_past_due(
  DocuSign.Connection.t(),
  String.t(),
  keyword()
) ::
  {:ok, DocuSign.Model.BillingInvoicesSummary.t()} | {:error, Req.Response.t()}
```

Get a list of past due invoices.
Returns a list past due invoices for the account and notes if payment can be made through the REST API.   Privileges Required: account administrator

### Parameters

- `connection` (DocuSign.Connection): Connection to server
- `account_id` (String.t): The external account number (int) or account ID GUID.
- `opts` (keyword): Optional parameters

### Returns

- `{:ok, DocuSign.Model.BillingInvoicesSummary.t}` on success
- `{:error, Req.Response.t}` on failure

---

*Consult [api-reference.md](api-reference.md) for complete listing*