Skip to main content
GET
Get Address
Single address by opaque partner-facing id. Cross-tenant lookups collapse to 404 with the same envelope as a genuinely non-existent id — existence of rows under other tenants is not leakable. A malformed address_id (wrong prefix, undecodable payload) raises InvalidAddressIdError which the Connect error handler renders as a 400 invalid_address_id envelope.

Authorizations

Authorization
string
header
required

Paste your Connect API key (sk_live_… for production, sk_test_… for sandbox) without the Bearer prefix. Mint and rotate keys from the admin panel.

Path Parameters

address_id
string
required

Opaque address id as returned from the list endpoint (addr_...).

Response

Successful Response

A single deposit-address row in the partner-facing shape.

id
string
required

Opaque partner-stable identifier (e.g. addr_VVNEVDpzb2xhbmE6RWhKO...). Pass to GET /addresses/:id to retrieve this row again.

asset
string
required

Asset code, uppercase (USDT, XAUT).

network
string
required

Network code, lowercase (solana, ethereum).

address
string
required

On-chain wallet address. Partner shares this with the user.

created_at
string<date-time>
required
external_ref
string | null

The partner's user id this address belongs to. Absent (key omitted from the JSON, not null) when the address is a tenant-treasury / pooled address minted by calling POST /addresses without external_ref.

memo
string | null

Memo / destination tag for chains that require one (XRP, XLM, COSMOS). NULL on chains that don't.