List Conductor ledger

List the credit charges for Conductor messages, newest first.

GEThttps://api.tried.com.au/conductor/ledger

Returns one ledger row per Conductor message, newest first, with the credits charged and how they were paid.

Request#

Field	Type	Required	Description
`limit`	integer	No	1 to 500. Default `100`.
`mine`	string	No	`true` returns only the signed-in user's rows. Ignored for API keys, which have no user.

Both are query parameters.

Example request#

curl "https://api.tried.com.au/conductor/ledger?limit=50" \
  -H "Authorization: Bearer $TRIED_API_KEY"

const res = await fetch("https://api.tried.com.au/conductor/ledger?limit=50", {
  headers: { Authorization: `Bearer ${process.env.TRIED_API_KEY}` },
});
const ledger = await res.json();

import os, requests

res = requests.get(
    "https://api.tried.com.au/conductor/ledger",
    headers={"Authorization": f"Bearer {os.environ['TRIED_API_KEY']}"},
    params={
        "limit": 50,
    },
)
ledger = res.json()

Response#

200 OK

[
  {
    "entry_id": "cc_0b2d4f6a8c1e3a5c7e9b1d3f",
    "user_id": null,
    "session_id": "conductor_1d3f5a7c9e2b4d6f8a0c2e4b",
    "tier": "default",
    "credits": 1,
    "source": "free_workspace",
    "cost": 0,
    "action": "build_dashboard",
    "created_timestamp": 1792395000000
  }
]

Field	Type	Description
`entry_id`	string	Ledger row ID, prefixed `cc_`.
`user_id`	string or null	Dashboard user who sent the message. `null` for API keys.
`tier`	string	`fast`, `default` or `advanced`.
`credits`	number	Credits charged.
`source`	string	`free_user`, `free_workspace` or `paid`.
`cost`	number	Dollars charged. `0` unless `source` is `paid`.
`action`	string	Action the message ran. See Send Conductor message.

Errors#

Status	When
`400`	`limit` is outside 1 to 500, or `mine` is not `true` or `false`.
`401`	Missing or invalid API key.
`403`	The key's IP allowlist or scopes reject the request. This route needs the `admin` scope.
`429`	Rate limit exceeded. See Rate limits.

See Errors for the body format.

Retell compatibility#

Retell's public API reference has no Conductor endpoints, so this route has no Retell SDK equivalent.