GET
/
v1
/
invoices
[
  {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "displayId": "<string>",
    "customer": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "externalId": "<string>",
      "name": "<string>"
    },
    "paymentAccount": {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "businessName": "<string>",
      "tradeName": "<string>",
      "taxId": "<string>",
      "email": "jsmith@example.com",
      "address": {
        "zipCode": "<string>",
        "number": "<string>",
        "street": "<string>",
        "neighborhood": "<string>",
        "city": "<string>",
        "state": "AC",
        "country": "Brasil",
        "complement": "<string>"
      }
    },
    "startDate": "2023-12-25",
    "endDate": "2023-12-25",
    "totalAmount": 1,
    "closedReason": "end_of_cycle",
    "payments": [
      {
        "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "amount": 123,
        "dueDate": "2023-12-25",
        "createdAt": "2023-11-07T05:31:56Z",
        "processedAt": "2023-11-07T05:31:56Z",
        "paymentMethod": "bolepix",
        "status": "created",
        "pixLink": "<string>",
        "bankSlipLink": "<string>"
      }
    ],
    "status": "open"
  }
]

Authorizations

​
X-API-KEY
string
header
required

API Key Authentication.

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
​
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
​
closedReason
enum<string>

The reason why the billing cycle was closed.

Available options:
end_of_cycle,
billing_end_day_updated