Admin
Create Admin Invoice
Create (and finalize) a one-time admin invoice for a user or organization (admin only).
Authorization
bearerAuth AuthorizationBearer <token>
Authentication required for all endpoints. Supports Better Auth user credentials and dedicated coworker bearer API keys.
In: header
Request Body
application/json
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://loading/v1/admin/invoices" \ -H "Content-Type: application/json" \ -d '{ "targetType": "organization", "targetId": "org_123", "credits": 100, "ttlDays": 30, "priceId": "price_123" }'{
"data": {
"invoiceId": "in_123",
"targetType": "organization",
"targetId": "org_123",
"targetName": "Acme",
"credits": 100,
"ttlDays": null,
"currency": "eur",
"amountDue": 12000,
"status": "open",
"dashboardUrl": "https://dashboard.stripe.com/acct_123/invoices/in_123"
},
"meta": {
"timestamp": "2025-01-01T00:00:00.000Z",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}
}{
"error": "Unauthorized",
"message": "Authentication required",
"kind": "organization_not_found",
"meta": {
"timestamp": "2021-01-01T00:00:00.000Z",
"requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
"path": "/v1/agents",
"method": "GET"
}
}{
"error": "Unauthorized",
"message": "Authentication required",
"kind": "organization_not_found",
"meta": {
"timestamp": "2021-01-01T00:00:00.000Z",
"requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
"path": "/v1/agents",
"method": "GET"
}
}{
"error": "Unauthorized",
"message": "Authentication required",
"kind": "organization_not_found",
"meta": {
"timestamp": "2021-01-01T00:00:00.000Z",
"requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
"path": "/v1/agents",
"method": "GET"
}
}{
"error": "Unauthorized",
"message": "Authentication required",
"kind": "organization_not_found",
"meta": {
"timestamp": "2021-01-01T00:00:00.000Z",
"requestId": "5091b3ea-994f-4417-8e04-2efc05dd8673",
"path": "/v1/agents",
"method": "GET"
}
}Create Admin Free Credit Grant POST
Grant free credits directly to a user or organization (admin only). Credits are created immediately without a Stripe invoice. Missing or invalid targets return 400 (not 404), matching admin invoice grants.
Delete Admin Invoice DELETE
Delete or void an admin invoice (admin only). Draft invoices are permanently deleted; open invoices are voided.
