Payments

List execution payments

Required API-key scope: payments:read. Optional query filters: execution_object_id, agent_object_id, final_state (pending/accomplished/refunded), funder, source_kind (user_funded/agent_funded), created_after / created_before (RFC3339, inclusive), page_token, page_size.

get /payments

Authorizations

x-api-key string header required

Talus API Key in the form key_id.secret. The API also accepts Authorization: ApiKey <key_id.secret>, but the docs UI is configured to send x-api-key.

Query Parameters

execution_object_id string | null
agent_object_id string | null
final_state string | null
funder string | null

Filter by the wallet address that funded the payment.

source_kind string | null

Filter by payment source kind (user_funded / agent_funded).

created_after string | null

Only include payments created at or after this RFC3339 timestamp.

created_before string | null

Only include payments created at or before this RFC3339 timestamp.

page_token integer | null
page_size integer | null

200application/json

Paginated list of payments

items object[] required
agent_object_id string | null
consumed_total integer<int64> required
created_at string required
execution_object_id string required
final_state string required
funder string | null
gas_budget_mist integer<int64> required
interface_revision integer | null
locked_budget_mist integer<int64> required
max_budget_mist integer<int64> required
onchain_created_at string | null

Checkpoint timestamp of the on-chain creation event; null for rows projected before on-chain timestamps were indexed (until a backfill + replay fills them).

payment_object_id string required
priority_fee_percentage integer<int64> required
priority_fee_reserve_mist integer<int64> required
refund_reason string | null
skill_id integer | null
source_kind string required
updated_at string required
metadata object required

Pagination metadata included in every listing response.

next_token integer | null

Token to pass as page_token to retrieve the next page. null means there are no more pages.

total_items integer<int64> required

Total number of items across all pages.

400

Invalid filter value

500

Internal server error