Billing

Lista las facturas de Stripe del workspace

Las 50 más recientes. Para seguir hacia atrás pasa starting_after con el id de la última factura de la página anterior. Aquí el cursor es obligatorio (no hay page): las facturas las pagina Stripe, y Stripe no tiene números de página.

Con paginate=true la respuesta es { data, has_more, next_cursor }: pasa next_cursor en starting_after hasta que has_more sea false. Excepción de este endpoint: aquí solo paginate=true activa esa forma. starting_after sin paginate sigue devolviendo el array de siempre, porque este endpoint ya lo aceptaba antes con el id de Stripe.

get/billing/invoices

Request

  • Base URL: https://api.met.meteor.com.co/api/v1
  • URL: https://api.met.meteor.com.co/api/v1/billing/invoices
  • Auth: one of:
    • bearer (a scheme the document does not define)
    • HTTP bearer

Query parameters

limitnumber

Cuántas facturas trae la página (1–100). Sin él se usan 50, como siempre; con paginate=true, 20.

starting_afterstring

Id (in_...) de la última factura que ya tienes: devuelve las anteriores a esa. Sin él se arranca desde la más reciente y la respuesta es idéntica a la de siempre. Con paginate=true pasa aquí el next_cursor de la página anterior; uno que no se entiende responde 400 validation_error con param: starting_after. Aquí no activa la forma nueva por sí solo: sin paginate=true la respuesta sigue siendo el array de siempre.

paginateboolean

Con true la respuesta llega como { data, has_more, next_cursor } en vez de la forma de siempre. Sin este parámetro (ni starting_after) la respuesta es exactamente la de hoy. En este endpoint es lo único que la activa: starting_after solo no cambia la forma.

Response

Sin paginate ni starting_after, la forma de siempre. Con ellos, { data, has_more, next_cursor }.

successtrue required

Siempre true en una respuesta 2xx.

Example response

{
  "data": [
    {
      "amount_due": 99,
      "amount_paid": 99,
      "created": "2026-07-01T00:00:07.000Z",
      "credit_notes": [
        {
          "amount": 49.5,
          "created": "2026-07-03T15:20:00.000Z",
          "number": "B1C2D3-0007-CN-01",
          "pdf_url": "https://pay.stripe.com/credit_notes/…/pdf"
        }
      ],
      "currency": "usd",
      "description": "Plan Crecimiento — julio 2026",
      "hosted_invoice_url": "https://invoice.stripe.com/i/acct_…",
      "id": "in_1Ok…",
      "invoice_pdf": "https://pay.stripe.com/invoice/…/pdf",
      "number": "B1C2D3-0007",
      "period_end": "2026-08-01T00:00:00.000Z",
      "period_start": "2026-07-01T00:00:00.000Z",
      "status": "paid"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.