OverviewPlatformsAPI Reference

List receipts

gethttps://api.mentio.dev/v1/billing/invoices

List the top-up orders, newest first, as Polar (the merchant of record) holds them.

This workspace's share of the billing customer's newest 100 orders; empty before the first top-up.

Authentication

AuthorizationBearer <token>Required

An API key (mk_live_...) from the dashboard or an OAuth access token. See Authentication.

Response

200Recent paid orders (receipts). Empty when the org has never paid
dataarray<object>Required

Paid orders, newest first; empty before the first top-up.

+Show 7 properties
idstringRequired

The Polar order id; what GET /v1/billing/invoices/{id}/url takes.

createdAtstringRequired

When the order was placed (ISO 8601).

statusstringRequired

The order status as Polar reports it (paid, refunded, ...).

paidbooleanRequired

Whether the order was paid.

totalAmountintegerRequired

What was charged, in minor units of currency, tax included.

currencystringRequired

ISO 4217 currency of the order (usd).

billingReasonstringnullableRequired

Why the order exists, as Polar reports it (purchase, subscription_cycle, ...); null when it does not say.

401Missing or invalid credentials
+Show 1 property
errorobjectRequired

The error.

+Show 4 properties
codestringRequired

Stable machine-readable code; branch on this, never on the message. Codes are additive: a client should treat one it does not know as a generic failure of the same status.

+Show 46 enum values
unauthorizedforbiddenread_only_keyvalidation_errornot_foundinvalid_cursorpayload_too_largeidempotency_key_in_useidempotency_key_reusedrate_limitedduplicate_keywordinsufficient_balancekeyword_limit_reachedbilling_not_configuredorder_not_creditedschedule_requiredunknown_channelnot_a_digesthourly_email_unsupportedslack_not_connectedslack_not_configuredtelegram_not_configuredfeed_unreadablefeed_login_requiredfeed_login_expiredfeed_limit_reachedfeed_auth_not_configuredemail_not_configuredinvalid_assigneeclassification_pendinginvalid_memberalready_memberlast_ownerduplicate_segmentfilter_too_complexduplicate_viewduplicate_groupdefault_groupdefault_group_contextgroup_changedinvalid_signaturewebhook_not_configuredinvalid_tokenprotected_userupstream_unavailableinternal_error
messagestringRequired

Human-readable detail; may change between releases.

requestIdstringOptional

The id of this request (also the X-Request-Id response header); quote it to support.

retryAfterSecondsintegerOptional

For rate_limited and other retryable errors: how long to wait before retrying (mirrors the Retry-After header).