Skip to main content
GET
Monthly Statement
For agencies Tuco invoices offline. Tuco bills you for the whole group, so your client workspaces have no card and no Stripe subscription — which leaves you working out what to charge each client by hand. This does the arithmetic.It charges nothing. You still send your own invoice.

Endpoint

  • Method: GET
  • Path: /api/agency/statement
  • Auth: Authorization: Bearer tucoagency_xxxxxxxxxxxxx (agency key)

Query parameters

How a line is priced

Rates come from your agency’s pricing, the same one the rest of Tuco uses. Each workspace reports the setupRateCents and monthlyRateCents it was priced at, so a number is always traceable to a rate.

Example request

Success response (200)

Every amount is in cents. Each line item is rounded to the nearest cent and the totals are sums of the rounded items, so the rows always add up to the total you print. Reading the second line above: ordered on 20 October, so setup is charged in full and the month is prorated at 12 of 31 days — 14500 × 12 ÷ 31 = 5613.

Fields

CSV

One row per line, plus a TOTAL row, with dollar amounts rather than cents — ready to paste into whatever you invoice from.

Error responses

A Stripe-billed agency gets a 409 on purpose. It already has real Stripe invoices; a second set of numbers computed a different way would be two sources of truth that can disagree.

In the dashboard

The same statement is the Billing tab in your agency view — month picker, totals, a per-client breakdown you can expand to individual lines, and the same CSV. No API key needed.