invoices

Cancel an unpaid invoice; its page stops taking payment

Changed on
post/api/v1/invoices/{id}/void

Request

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

Path parameters

idstring required

Invoice id (in_...).

Response

Void (voiding a void invoice answers the same).

idstring required
status'draft' | 'open' | 'paid' | 'void' | 'uncollectible' required
amountinteger required

Total, in cents.

amount_paidinteger
amount_remaininginteger
currencystring required
urlstring nullable required

Stripe’s hosted invoice page, where the customer pays.

pdf_urlstring nullable
numberstring nullable
descriptionstring nullable
due_datestring date-time nullable
createdstring date-time required
paid_atstring date-time nullable
voided_atstring date-time nullable
last_sent_atstring date-time nullable
orgo_feeinteger

Orgo’s fee in cents: Stripe’s card and Invoicing fees.

payoutinteger

What reaches your bank when it is paid, in cents.

workspace_idstring uuid nullable
metadataobject

Example response

{
  "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