Skip to main content
GET
Get top-up configuration

Authorizations

Authorization
string
header
required

Monid API key (Authorization: Bearer mk_...) or Clerk-issued JWT. Each operation lists the ONE scope an API key needs. {resource}:* grants every action on that resource; * grants everything; Clerk sessions hold *. Operations with an empty list need no scope. Scope catalog: GET /v1/api-keys/scopes.

Headers

X-Monid-Agent-Model
string

Model driving the calling agent. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Maximum string length: 256
X-Monid-Agent-Harness
string

Agent harness or client making the call (e.g. a coding agent, an agent framework). Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Maximum string length: 256
X-Monid-Agent-Session-Id
string

Caller-side session identifier, so the calls of one agent session (discover → inspect → run → polling) can be correlated. Optional; a value that is empty, longer than 256 characters or not printable ASCII is ignored (never an error).

Maximum string length: 256

Response

Top-up fees, limits, promotion tiers, and presets

minAmount
number
required

Minimum top-up amount in dollars.

Example:

5

currency
enum<string>
required

Top-up currency (currently always USD).

Available options:
USD
processingFee
object
required
tiers
object[]
required

Bonus tiers for the applied promotion, ascending. Any amount rounds DOWN to a tier; the rate applies to the actual amount.

presets
number[]
required

Preset amounts in dollars, display order. Bonuses are client-derived from tiers (round-down tier match).

defaultPreset
number
required

Pre-selected preset amount in dollars.

Example:

100

autoReload
object
required
maxAmount
number

Maximum top-up amount in dollars. Omitted when no app-level cap is configured.

Example:

1000

promotion
object

Active promotion. Absent when the baseline (default) applies — no promotion badge.