invoices

Your invoices, newest first

Changed on

Read from Orgo’s record of your invoices, so a new invoice is here as soon as it is made. Statuses and amounts follow Stripe: they are updated on each of Stripe’s invoice events and whenever you read, send or void one, so a payment can take a few seconds to show here; GET /api/v1/invoices/{id} reads Stripe at once. Pass next_cursor back as cursor for the next page, with the same filters.

get/api/v1/invoices

Request

  • Base URL
    https://www.orgo.ai
  • Auth
    HTTP bearer

Query parameters

limitinteger
cursorstring
status'draft' | 'open' | 'paid' | 'void' | 'uncollectible'
workspace_idstring uuid

Response

A page of invoices.

next_cursorstring nullable required

Pass as cursor for the next page; null on the last.

Example response

{
  "invoices": [
    {
      "id": "in_1QxYz2AbCdEf",
      "status": "open",
      "amount": 120000,
      "amount_paid": 0,
      "amount_remaining": 120000,
      "currency": "usd",
      "url": "https://invoice.stripe.com/i/acct_123/test_abc",
      "pdf_url": "https://pay.stripe.com/invoice/acct_123/test_abc/pdf",
      "number": "A1B2C3D4-0001",
      "description": "March security audit",
      "customer": {
        "email": "ap@acme.com",
        "phone": null,
        "name": "Acme Inc."
      },
      "line_items": [
        {
          "description": "March security audit",
          "quantity": 1,
          "unit_amount": 120000,
          "amount": 120000
        }
      ],
      "due_date": "2026-11-01T23:59:59.000Z",
      "created": "2026-10-07T18:00:00.000Z",
      "paid_at": null,
      "voided_at": null,
      "last_sent_at": null,
      "orgo_fee": 4110,
      "payout": 115890,
      "workspace_id": null,
      "metadata": {
        "project": "audit-2026-03"
      }
    }
  ]
}

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the non-success response with the status