Generate Invoice Now

Manually trigger invoice generation for this organization.

Useful for testing the billing flow or generating retroactive invoices. Requires ADMIN permission.

Line items follow the v2 (modality+features, D8) composition: flat monthly fee + per-modality feature usage in natural units and dollars + the plan’s included-usage pool as a deduction; only usage beyond the pool is due. The total always reconciles to the month’s ledger charges (see pricing_v2).

Example:

# Dry run
response = await client.post(
    "/v1/organizations/billing/generate-invoice",
    json={"dry_run": true}
)

# Actually generate
response = await client.post(
    "/v1/organizations/billing/generate-invoice",
    json={"billing_month": "2026-01"}
)

POST /v1/organizations/billing/generate-invoice

Generate Invoice Now

cURL

curl --request POST \
  --url https://api.mixpeek.com/v1/organizations/billing/generate-invoice \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "billing_month": "<string>",
  "dry_run": false
}
'

200

{}

Authorizations

Authorization · string · header · required

Mixpeek API key, sent as Authorization: Bearer mxp_sk_.... Create one in Studio under Settings → API Keys, or with an admin key via POST /v1/organizations/users/{user_email}/api-keys. A missing header returns 403; an invalid or revoked key returns 401.

Body

application/json

billing_month · string | null

Billing month (YYYY-MM). Defaults to previous month.

dry_run · boolean · default: false

If true, show what would be invoiced without creating Stripe invoice.

Response

200

application/json

Successful Response

The response is of type Response Generate Invoice Now V1 Organizations Billing Generate Invoice Post · object.