Skip to main content
GET
List managed balance refill policies

Authorizations

x-app-id
string
header
required

Your application ID. Required for all app-tier and user-tier routes.

Authorization
string
header
required

JWT access token returned by POST /auth/verify. Required for user-tier routes.

Response

200

id
string
required

Policy id.

targetChainId
integer
required

Chain kept topped up.

targetTokenAddress
string
required

USDC contract on that chain.

targetTokenSymbol
enum<string>
required

Always USDC.

Available options:
USDC
minimumRaw
string
required

Refill when the target-chain balance falls below this. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00).

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

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

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

Most that can be refilled per day. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00).

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

Most one refill may pay in transfer fees. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00).

Pattern: ^[1-9][0-9]*$
status
enum<string>
required

enabled: refills run. paused: no refills until re-enabled.

Available options:
enabled,
paused
cooldownSeconds
integer
required

Minimum seconds between refills.

Required range: x >= 60
lastObservedRaw
string | null
required

Target-chain balance at the last check. USD in 6-decimal atomic units, as an integer string (1000000 = $1.00).

Pattern: ^[0-9]+$
lastEvaluatedAt
string<date-time> | null
required

When the balance was last checked.

nextEligibleAt
string<date-time> | null
required

Earliest time the next refill may run.

consentedAt
string<date-time>
required

When the user consented.

createdAt
string<date-time>
required

Creation time.

updatedAt
string<date-time>
required

Time of the last change.

latestAttempt
object | null
required

Most recent refill attempt, if any.