Skip to main content
GET
List recent managed balance refill attempts

Integration guide

Authorizations

x-app-id
string
header
required

Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.

Authorization
string
header
required

JWT access token from POST /auth/verify. Required with x-app-id on user routes. On the smart-route quote it is optional and turns a preview into an executable quote.

Path Parameters

policyId
string
required

Response

200

id
string
required

Refill attempt id.

policyId
string
required

Policy that triggered it.

status
enum<string>
required

reserved: funds set aside, not yet moving. executing: moving. completed or failed: final.

Available options:
reserved,
executing,
completed,
failed
triggerBalanceRaw
string
required

Target-chain balance that triggered the refill. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00).

Pattern: ^[0-9]+$
requestedDeliveryRaw
string
required

Amount the refill aims to deliver. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00).

Pattern: ^[1-9][0-9]*$
sourceAmountRaw
string
required

Amount taken from the source chain. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00).

Pattern: ^[1-9][0-9]*$
completedAmountRaw
string | null
required

Amount delivered; null until complete. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00).

Pattern: ^[0-9]+$
sourceChainId
integer
required

Chain the funds came from.

targetChainId
integer
required

Chain refilled.

feeRaw
string | null
required

Transfer fee, deducted from the amount moved. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00).

Pattern: ^[0-9]+$
errorMessage
string | null
required

Readable failure reason.

startedAt
string<date-time> | null
required

When the transfer started.

completedAt
string<date-time> | null
required

When it finished.

createdAt
string<date-time>
required

When the attempt was created.