Download a statement as CSV
Returns one month’s statement as a CSV file named billing_statement_YYYY-MM.csv. The
kind and project filters apply as they do to
Retrieve a statement.
The statement is computed on request from the usage reporting pipeline, so the
response is 502 when that pipeline is unavailable.
Permissions
Authenticate with a Personal access token whose holder is an owner or admin of the space. A project API token is not accepted on this endpoint, and a Personal access token has no scopes: the holder’s role in the space is the whole authorization decision.
Authentication
Personal access token authentication for space-wide administration.
Send HTTP Basic auth with an empty username and the Personal access token as
the password. A Personal access token carries your own authority rather than a
project's: it is created from your user menu in the Dashboard, is prefixed
pat_, and has no scopes. The holder must be an owner or admin of the space
named by the subdomain, and the token acts only on that space.
Example:
Authorization: Basic base64(:pat_...)
Query parameters
The calendar month, as YYYY-MM. A month before the space existed is rejected with month_precedes_space_creation, and a future month with month_is_in_the_future.
Return only these usage kinds in usage_by_kind and in each project's breakdown. Repeat the parameter for each kind.
Restrict the per-project breakdown to these project ids. Repeat the parameter for each project.
Response headers
Names the download billing_statement_YYYY-MM.csv.