List counterparties

List counterparties visible to the agent.

GET/v1/agent-api/counterparties

Query parameters

addressstringOptional

Only counterparties with a wallet rail at this address; bank rails never match

network"base" | "arc"Optional

Only counterparties owning a wallet address in this network class; a matching rail can omit network when its configured destination is unavailable to the agent; such a rail cannot receive an agent send until that configuration or the organization's capability changes; bank rails never match

Responses

200

Visible counterparties

400

Malformed address, unknown network, or network not enabled

Response fields

counterpartiesarray of objectRequired

counterparties[].idstringRequired

counterparties[].namestringRequired

counterparties[].status"ready" | "awaiting_details"Required

counterparties[].railsarray of objectRequired

Updated October 29, 2026 Generated from the agent API's published OpenAPI document View as Markdown