Invoices API
Work with the public `/invoices` API and the invoice status model documented for Corinthian.
The public invoice API is:
/invoicesDocumented Endpoints
| Method | Path | Purpose |
|---|---|---|
GET | /invoices | list invoices |
GET | /invoices/summary | fetch invoice summary data |
GET | /invoices/{id} | fetch one invoice |
POST | /invoices | create an invoice shell |
PATCH | /invoices/{id}/status | update invoice status |
POST | /invoices/{id}/mark-paid | mark invoice paid |
POST | /invoices/{id}/refund | refund invoice |
DELETE | /invoices/{id} | delete invoice |
Invoice Shape
The documented core fields include:
{
"id": "inv_123",
"type": "invoice",
"status": "draft",
"createdAt": "2026-03-01T10:00:00.000Z",
"updatedAt": "2026-03-01T10:00:00.000Z",
"paidAt": null,
"userId": "usr_123"
}Status Values
draftpendingunpaidpaidoverduecanceledscheduledrefunded
Create Example
The create endpoint initializes an invoice shell with a small request body.
curl -X POST https://api.conduitt.io/invoices \
-H "Authorization: Bearer ck_test_your_key" \
-H "Content-Type: application/json" \
-d '{
"type": "invoice",
"status": "draft"
}'This create endpoint initializes a zero-amount USD invoice with an auto-generated number.
List Example
curl "https://api.conduitt.io/invoices?status=overdue&limit=20" \
-H "Authorization: Bearer ck_test_your_key"Use pagination=cursor only if you want the cursor response model.
Treat status transitions as API-controlled behavior and use the documented invoice endpoints together with the saved-invoice and payment flows elsewhere in the product.