GET
/
v1
/
invoices
/

Query Parameters

startDateFrom
string

Filter invoices by the start date of the billing cycle. The date must be in ISO 8601 format.

startDateTo
string

Filter invoices by the end date of the billing cycle. The date must be in ISO 8601 format.

endDateFrom
string

Filter invoices by the end date of the billing cycle. The date must be in ISO 8601 format.

endDateTo
string

Filter invoices by the end date of the billing cycle. The date must be in ISO 8601 format.

customerId
string

The internal unique identifier of the customer.

externalCustomerId
string

The external unique identifier of the customer provided by the tenant.

Response

200 - application/json
id
string
required

The unique identifier of the invoice.

displayId
string
required

The human-readable identifier of the invoice.

customer
object
required

The customer associated with this invoice.

paymentAccount
object
required

The payment account used for this invoice.

startDate
string
required

The start date of the billing period.

endDate
string
required

The end date of the billing period.

totalAmount
number
required

The total amount to be paid for this invoice.

Required range: x > 0
closedReason
enum<string>

The reason why the billing cycle was closed.

Available options:
end_of_cycle,
billing_end_day_updated
payments
object[] | null
required

List of payments associated with this invoice.

status
enum<string>
required

The current status of the invoice.

Available options:
open,
closed,
paid,
canceled