Pular para o conteúdo principal
GET
/
workspaces
/
{workspaceId}
/
billing-accounts
/
{billingAccountId}
/
invoices
Listar faturas
curl --request GET \
  --url https://api.altostrat.io/workspaces/{workspaceId}/billing-accounts/{billingAccountId}/invoices \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "in_1Kb...",
      "customer_id": "cus_...",
      "status": "paid",
      "amount_due": 999,
      "amount_paid": 999,
      "currency": "usd",
      "created_at": "2025-10-29T00:40:06.000000Z",
      "subtotal": 1099,
      "total": 999,
      "tax": 0,
      "discount_amount": 100,
      "discount_names": [
        "Cupom de 10% de Desconto"
      ],
      "lines": [
        {
          "id": "il_1Kb...",
          "description": "10 × Locais",
          "amount": 1000,
          "currency": "usd",
          "quantity": 10,
          "price_id": "price_...",
          "unit_amount": 100,
          "product_name": "Locais"
        }
      ],
      "due_date": null,
      "hosted_invoice_url": "https://invoice.stripe.com/...",
      "invoice_pdf": "https://pay.stripe.com/...",
      "number": "AB123-001"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>",
  "previous_cursor": "<string>"
}

Authorizations

​
Authorization
string
header
required

Insira seu JWT no formato: Bearer {token}

Path Parameters

​
workspaceId
string
required

O ID do workspace.

Example:

"ws_a1b2c3d4e5f6g7h8"

​
billingAccountId
string
required

O ID da conta de faturamento, que corresponde a um ID de Cliente do Stripe (cus_...).

Example:

"cus_a1b2c3d4e5f6g7h8"

Query Parameters

​
limit
integer
default:100

Um limite no número de objetos a serem retornados. O limite pode variar entre 1 e 200, e o padrão é 100.

​
after
string

Um cursor para uso em paginação. after é um ID de objeto que define sua posição na lista. Por exemplo, se você fizer uma requisição de lista e receber 100 objetos, terminando com inv_..., sua chamada subsequente pode incluir after=inv_... para buscar a próxima página da lista.

​
before
string

Um cursor para uso em paginação. before é um ID de objeto que define sua posição na lista. Por exemplo, se você fizer uma requisição de lista e receber 100 objetos, começando com inv_..., sua chamada subsequente pode incluir before=inv_... para buscar a página anterior da lista.

Response

Uma lista de objetos de fatura.

​
data
object[]
​
has_more
boolean
​
next_cursor
string | null
​
previous_cursor
string | null