---
title: "Lista las facturas de Stripe del workspace"
method: GET
path: "/billing/invoices"
tags: ["Billing"]
---

# Lista las facturas de Stripe del workspace

`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

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.

## Query parameters

- `limit` number
- `starting_after` string
- `paginate` boolean

## Response `200`

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

- object: Sobre en el que viaja toda respuesta correcta de la API. El recurso está en `data`. Los SDKs oficiales lo desenvuelven por ti; un cliente hecho a mano tiene que leer `.data`.
  - `success` true, required: Siempre `true` en una respuesta 2xx.
  - `data` union, required
    - InvoiceResponseDto[]
      - `amount_due` number, required: Importe adeudado, en la moneda de `currency` y ya en unidad mayor (no en centavos). Las monedas sin decimales no se dividen.
      - `amount_paid` number, required: Importe efectivamente pagado, en la moneda de `currency`.
      - `amount_refunded` number: Lo devuelto de esta factura, en la moneda de `currency` y en unidad mayor: lo de sus notas crédito —en dinero o acreditadas al saldo del cliente— y, si no tiene ninguna, lo reembolsado sobre el pago. `0` = no se devolvió nada. Falta en cuentas gestionadas y cuando no se pudo saber (no se pudo consultar a tiempo, o el pago es más viejo que lo consultado): ausente no quiere decir `0`.
      - `created` string, nullable, required
      - `credit_notes` CreditNoteResponseDto[]: Notas crédito de la factura (sin las anuladas), incluidas las acreditadas al saldo del cliente. Falta en cuentas gestionadas y cuando no se pudieron consultar; ausente no quiere decir que no haya notas.
        - `amount` number, required: Total de la nota, en la moneda de la factura y en unidad mayor.
        - `created` string, nullable, required
        - `number` string, nullable, required: Número visible de la nota crédito.
        - `pdf_url` string, nullable, required: PDF de la nota crédito. Es un enlace temporal que emite Stripe.
      - `currency` string, required: Moneda de la factura, en minúsculas. Puede no ser USD.
      - `description` string, nullable, required
      - `hosted_invoice_url` string, nullable, required: Página de la factura alojada por Stripe, también temporal.
      - `id` string, nullable, required
      - `invoice_pdf` string, nullable, required: PDF de la factura. Es un enlace temporal que emite Stripe.
      - `number` string, nullable, required: Número visible de la factura.
      - `period_end` string, nullable, required
      - `period_start` string, nullable, required
      - `status` string, nullable, required
    - InvoiceListPageDto
      - `data` InvoiceResponseDto[], required
        - `amount_due` number, required: Importe adeudado, en la moneda de `currency` y ya en unidad mayor (no en centavos). Las monedas sin decimales no se dividen.
        - `amount_paid` number, required: Importe efectivamente pagado, en la moneda de `currency`.
        - `amount_refunded` number: Lo devuelto de esta factura, en la moneda de `currency` y en unidad mayor: lo de sus notas crédito —en dinero o acreditadas al saldo del cliente— y, si no tiene ninguna, lo reembolsado sobre el pago. `0` = no se devolvió nada. Falta en cuentas gestionadas y cuando no se pudo saber (no se pudo consultar a tiempo, o el pago es más viejo que lo consultado): ausente no quiere decir `0`.
        - `created` string, nullable, required
        - `credit_notes` CreditNoteResponseDto[]: Notas crédito de la factura (sin las anuladas), incluidas las acreditadas al saldo del cliente. Falta en cuentas gestionadas y cuando no se pudieron consultar; ausente no quiere decir que no haya notas.
          - `amount` number, required: Total de la nota, en la moneda de la factura y en unidad mayor.
          - `created` string, nullable, required
          - `number` string, nullable, required: Número visible de la nota crédito.
          - `pdf_url` string, nullable, required: PDF de la nota crédito. Es un enlace temporal que emite Stripe.
        - `currency` string, required: Moneda de la factura, en minúsculas. Puede no ser USD.
        - `description` string, nullable, required
        - `hosted_invoice_url` string, nullable, required: Página de la factura alojada por Stripe, también temporal.
        - `id` string, nullable, required
        - `invoice_pdf` string, nullable, required: PDF de la factura. Es un enlace temporal que emite Stripe.
        - `number` string, nullable, required: Número visible de la factura.
        - `period_end` string, nullable, required
        - `period_start` string, nullable, required
        - `status` string, nullable, required
      - `has_more` boolean, required: `true` si hay más filas después de esta página.
      - `next_cursor` string, nullable, required: Cursor opaco para `starting_after`. `null` cuando `has_more` es `false`.

## Other responses

- `400`: La request no es válida: un campo no pasa validación, falta un parámetro requerido o el recurso no admite la transición solicitada.
- `401`: API key ausente, inválida, revocada o expirada — o el workspace está bloqueado.
- `403`: La key está autenticada pero no puede ejecutar esta operación: scope faltante, capacidad deshabilitada, modo test restringido o recurso fuera de su cartera.
- `404`: El recurso no existe o no está disponible dentro del alcance de la key. No revela la existencia de recursos de otros tenants.
- `429`: Se superó el límite por minuto de la key o la cuota del plan. Respeta `Retry-After`; el SDK ya reintenta solo.
- `500`: Error del servidor o del Met que ejecutaba. El SDK reintenta los 5xx con backoff.

---

[API](https://skmtc.dev/meteor/apis/met-public-api.md) · [All operations](https://skmtc.dev/meteor/apis/met-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/meteor/apis/met-public-api/revisions/5d9ca294295c?raw)