get /v1/invoices

List all invoices

GetInvoices

<p>You can list all invoices, or list the invoices for a specific customer. The invoices are returned sorted by creation date, with the most recently created invoices appearing first.</p>

Parameters

Name In Type Required Description
collection_method query string no The collection method of the invoice to retrieve. Either `charge_automatically` or `send_invoice`.
created query object | integer no Only return invoices that were created during the given date interval.
customer query string no Only return invoices for the customer specified by this customer ID.
customer_account query string no Only return invoices for the account representing the customer specified by this account ID.
due_date query object | integer no
ending_before query string no A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, starting with `obj_bar`, your subsequent call can include `ending_before=obj_bar` in order to fetch the previous page of the list.
expand query string[] no Specifies which fields in the response should be expanded.
limit query integer no A limit on the number of objects to be returned. Limit can range between 1 and 100, and the default is 10.
starting_after query string no A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 100 objects, ending with `obj_foo`, your subsequent call can include `starting_after=obj_foo` in order to fetch the next page of the list.
status query string no The status of the invoice, one of `draft`, `open`, `paid`, `uncollectible`, or `void`. [Learn more](https://docs.stripe.com/billing/invoices/workflow#workflow-overview)
subscription query string no Only return invoices for the subscription specified by this subscription ID.

Request Body

application/x-www-form-urlencoded

Responses

200 Successful response.
default Error response.