GET
Get a report

Authorizations

Authorization
string
header
required

An API key minted in the console (ctd_…). Authenticates; never authorizes funds. A key carries scopes (read, wallets.write, transactions.write, events.write, webhooks.write, policy.write) and may be limited to vaults, to IP addresses, and in lifetime — see Authentication.

Path Parameters

id
string<uuid>
required

Response

The report.

id
string<uuid>
required
type
enum<string>
required
Available options:
wallet_statement,
custody,
overview
format
enum<string>
required
Available options:
pdf,
csv
network
enum<string>
required

The network the data lives on. Required wherever it appears in a request — there is no default network. One your installation does not serve: 422 network_not_served.

Available options:
mainnet,
testnet
status
enum<string>
required
Available options:
queued,
running,
ready,
failed
wallet
object | null
required

The statement's wallet; null for an organization-wide report.

window_days
integer | null
required

The days a statement covers, up to when it was built; null for an organization-wide report.

failure_reason
string | null
required

Set when status is failed. Human-readable; not stable.

created_at
string<date-time>
required
completed_at
string<date-time> | null
required

When it became ready or failed.

file
object | null
required

The file GET /reports/{id}/file streams; null until ready.