Skip to main content
GET
curl

Authorizations

Authorization
string
header
required

An API key (sig_...), or a session token from the web app.

Path Parameters

agentId
string<uuid>
required

The agent's id.

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

Query Parameters

period
enum<string>

month (default), 30d, 7d or all.

Available options:
month,
30d,
7d,
all

Response

The spend.

object
enum<string>
required
Available options:
spend
agentId
string<uuid>
required
Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
Example:

"3f1c2d4e-5a6b-4c7d-8e9f-0a1b2c3d4e5f"

period
enum<string>
required
Available options:
month,
30d,
7d,
all
since
string<date-time> | null
required
Example:

"2026-10-02T14:03:07.120Z"

copilot
object
required

The in-app copilot's turns on this agent.

quickChecks
object
required
clientReported
object
required

What MCP clients reported for their own model.

retell
object
required

Simulated runs: the customer's Retell spend and SignalMD's own share.

totalUsd
number
required
byGoal
object[]
required