Cowdidocs
API ReferenceStatements

Get the caller's statement

GET
/v1/statements/{id}

Returns one of the caller's own statements by its id. Requires an authenticated, active user. Returns 404 when the statement does not exist or does not belong to the caller.

Authorization

oauth2
AuthorizationBearer <token>

Create a client with POST /v1/oauth/clients, then exchange its credentials for an access token. AUTHORIZATION_CODE clients act on behalf of a signed-in user and always use PKCE; CLIENT_CREDENTIALS clients act as themselves. A client may only be granted scopes its creator already holds — read the grantable list from GET /v1/oauth/clients/scopes.

In: header

Path Parameters

id*string

Unique identifier of the statement.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/statements/3fa85f64-5717-4562-b3fc-2c963f66afa6"
{  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",  "type": "TRANSACTION_HISTORY",  "audience": "USER",  "status": "PENDING",  "parameters": {},  "data_as_of": "2026-01-15T00:00:00Z",  "documents": [    {      "format": "CSV",      "status": "PENDING",      "failure_reason": "[TOO_MANY_ROWS] The statement has more rows than the CSV export supports.",      "failure_code": "TOO_MANY_ROWS"    }  ],  "requested_at": "2026-01-15T09:30:00Z",  "resource_id": "string"}
{  "code": "BAD_REQUEST",  "description": "Bad Request"}
{  "code": "UNAUTHORISED",  "description": "Unauthorised"}
{  "code": "FORBIDDEN",  "description": "Forbidden"}
{  "code": "BAD_REQUEST",  "description": "Invalid input"}
{  "code": "RATE_LIMIT_EXCEEDED",  "description": "Too Many Requests"}
{  "code": "INTERNAL_ERROR",  "description": "Internal Server Error"}

Create a statement POST

Creates a statement, or returns the caller's existing statement for the same type and parameters. An expired artifact regenerates, and a retriable failure retries automatically. Requires an authenticated, active user. Accepts an optional `Idempotency-Key` header that replays the same response on a retried request. Returns 404 when `type` names no registered statement type. Generation runs asynchronously; poll `Get a statement` until every document reaches `READY`.

List a statement's documents GET

Lists the per-format renditions of one of the caller's own statements. Each entry carries a rendition's status and, when it failed, why. Requires an authenticated, active user. Returns 404 when the statement does not exist or does not belong to the caller.