Saltar al contenido principal
GET
/
workspaces
/
{workspaceId}
/
billing-accounts
/
{billingAccountId}
/
invoices
Listar facturas
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": [
        "Cupón 10% Descuento"
      ],
      "lines": [
        {
          "id": "il_1Kb...",
          "description": "10 × Ubicaciones",
          "amount": 1000,
          "currency": "usd",
          "quantity": 10,
          "price_id": "price_...",
          "unit_amount": 100,
          "product_name": "Locations"
        }
      ],
      "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

Introduzca su JWT en el formato: Bearer {token}

Path Parameters

​
workspaceId
string
required

El ID del espacio de trabajo.

Example:

"ws_a1b2c3d4e5f6g7h8"

​
billingAccountId
string
required

El ID de la cuenta de facturación, que corresponde a un ID de Cliente de Stripe (cus_...).

Example:

"cus_a1b2c3d4e5f6g7h8"

Query Parameters

​
limit
integer
default:100

Un límite en el número de objetos a devolver. El límite puede oscilar entre 1 y 200, y el valor predeterminado es 100.

​
after
string

Un cursor para usar en la paginación. after es un ID de objeto que define su lugar en la lista. Por ejemplo, si realiza una solicitud de lista y recibe 100 objetos, terminando con inv_..., su llamada posterior puede incluir after=inv_... para obtener la siguiente página de la lista.

​
before
string

Un cursor para usar en la paginación. before es un ID de objeto que define su lugar en la lista. Por ejemplo, si realiza una solicitud de lista y recibe 100 objetos, comenzando con inv_..., su llamada posterior puede incluir before=inv_... para obtener la página anterior de la lista.

Response

Una lista de objetos de factura.

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