---
title: "Invoices"
method: GET
path: "/v1/invoices"
tags: ["billing"]
---

# Invoices

`GET /v1/invoices`

## Request

- Base URL: `https://api.portproof.org`
- URL: `https://api.portproof.org/v1/invoices`
- Auth: HTTP bearer

Cursor-paginated: `?limit=` (default 50, max 200) and `?cursor=` from the previous `next_cursor`.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Default Response

- object
  - `data` object[], required
    - `id` string, required
    - `org_id` string, required
    - `provider` 'manual' | 'paddle' | 'stripe' | 'coingate' | 'sepa', required
    - `total_cents` integer, required
    - `currency` 'EUR' | 'USD', required
    - `state` 'draft' | 'open' | 'paid' | 'void', required
    - `due_at` string, date-time, nullable, required
    - `lines` object[], required
      - `description` string, required
      - `quantity` integer, required
      - `unit_cents` integer, required
      - `total_cents` integer, required
      - `ref_type` string, nullable
      - `ref_id` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `next_cursor` string, nullable, required

## Other responses

- `401`: Default Response
- `403`: Default Response

---

[API](https://skmtc.dev/portproof/apis/portproof-api.md) · [All operations](https://skmtc.dev/portproof/apis/portproof-api/llms.txt) · [OpenAPI document](https://skmtc.dev/portproof/apis/portproof-api/revisions/4143916c0fac?raw)