Skip to main content
GET
Read accepted usage and monthly invoice settlements
Requires authentication and returns only the caller’s workspace records. This endpoint does not generate, approve, or pay invoices. usage contains up to 500 grouped records. Read environment, classification, quantity, currency, and amount_cents together. rated means the pricing snapshot was preserved at billing acceptance. Sandbox, free plans, consumer plans, approved pilots, and historical mint retries are excluded from business usage charges. Unresolved core pricing or environment evidence holds the month for staff review. settlements contains up to 200 monthly invoice records, newest first. A DRAFT is not payable. Staff must review the accepted commercial agreement, tax, and billing country before issue. automatic_collection is always false for this workflow: issuing an invoice does not charge a saved payment method. The UTC billing month uses acceptance time. Existing aggregate counters are not retroactively invoiced. Continue using the same mint idempotency key if a mint reports that its billing receipt could not be confirmed. Amounts ending in _cents are integer cents. The separately retrieved invoice uses currency units. For example, amount_cents: 2500 corresponds to USD 25.00.

Authorizations

X-API-Key
string
header
required

API key for machine-to-machine authentication

Response

Accepted usage and settlements

settlements
object[]
usage
object[]
settlement_mode
enum<string>
Available options:
draft_then_staff_review
automatic_collection
enum<boolean>
Available options:
false
usage_limit
integer
Example:

500

settlement_limit
integer
Example:

200