Skip to main content
GET
Orders placed by AI agents over a date range

Authorizations

Authorization
string
header
required

Bearer token authentication. Requires a company-admin token whose role holds reports.view.

Query Parameters

from
string<date>

First day of the range, inclusive, as YYYY-MM-DD in the tz zone. Defaults to 29 days before to, so the default range is thirty days. A value that is not this exact shape returns 400.

Example:

"2026-10-16"

to
string<date>

Last day of the range, inclusive, as YYYY-MM-DD in the tz zone. Defaults to today, or to 29 days after from when only from is sent. A range longer than 92 days, or one that ends before it starts, returns 400.

Example:

"2026-11-14"

tz
string

IANA timezone name (e.g. America/Denver) or Rails-style alias (Eastern Time (US & Canada)) used to anchor "today" boundaries and hour-of-day bucketing. The frontend sends Intl.DateTimeFormat().resolvedOptions().timeZone. Unknown or malformed values silently fall back to UTC — callers omit the param when the endpoint doesn't need wall-clock alignment (see CURRENT-3077).

Example:

"America/Denver"

country
string

ISO alpha-2 code of one of the requesting company's configured countries (see GET /countries). When present, every service on this endpoint filters its data to that country and reports money in the country's own currency. Omit (or send "all") for the aggregate-across-countries view, which is the default and matches pre-Phase-004 behavior. Unknown ISO codes or ones the company is not configured for return 400.

Example:

"US"

Response

Agent sales payload

from
string<date>
required
to
string<date>
required
time_zone
string
required

Name of the zone the dates are cut in.

currency
string
required

ISO 4217 three-letter code (uppercase).

Required string length: 3
Example:

"USD"

total
object
required
classifications
object[]
required

One row per classification, always all four, in the order verified, declared, inferred, unattributed.

recorded_since
string<date> | null
required

The day, in the tz zone, Fluid first recorded an agent on one of the company's orders, or null when it never has. Orders before it count as unattributed because nothing was recorded, so a range that starts earlier understates agent sales.

agents
object[]
required

Each named agent under each classification, highest revenue first. One agent can appear under two classifications.

Maximum array length: 50
meta
object