Statuses

Agent Pay status: Approve does not execute. Execution: not enabled. ACH settlement: not enabled. prepare_payment never moves money. Machine-readable: /docs/agents/status.json.

Generated from code. Machine-readable: /docs/agents/reference/statuses.json.

Payment draft status

Applies to: get_payment_status.status.

Read-time expiry applies: a pending draft past its approval window, or an approved draft past executableUntil, reads as expired.

Value	Meaning
`draft`	Created and not yet submitted for approval.
`requires_approval`	Prepared by prepare_payment and waiting for a human decision.
`approved`	A human approved it and a signed authorization envelope exists. Nothing has executed.
`rejected`	A human rejected it.
`expired`	The approval window or the signed executableUntil passed. A new prepare and approval are needed.
`revoked`	An approved authorization was revoked before use. Its signature is cleared.
`pending_operator_approval`	Waiting for the operator to approve or reject.
`awaiting_approval`	Waiting for approval.
`recipient_information_required`	The draft needs payee details before approval.
`execution_pending`	Reserved for execution, which is not enabled.
`completed`	Reserved for confirmed provider success, which cannot happen while execution is not enabled.
`failed`	Reserved for a failed execution attempt.

Statuses governed by the approval window

Applies to: Payment drafts (expiresAt).

Value	Meaning
`draft`	Expires when expiresAt passes.
`requires_approval`	Expires when expiresAt passes.
`pending_operator_approval`	Expires when expiresAt passes.
`awaiting_approval`	Expires when expiresAt passes.
`recipient_information_required`	Expires when expiresAt passes.

Statuses governed by executableUntil

Applies to: Approved payment drafts and their envelopes.

Value	Meaning
`approved`	Reads as expired once the server clock reaches executableUntil (zero skew).
`execution_pending`	Reads as expired once the server clock reaches executableUntil.

prepare_payment policy result

Applies to: prepare_payment.policy_result.

Value	Meaning
`allowed_with_approval`	Policy allows the payment to be proposed. A human still has to approve it.
`blocked`	Policy blocks the payment. No approvable draft is created.

Approval queue: pending

Applies to: The operator approvals queue.

Value	Meaning
`draft`	Shown as pending.
`requires_approval`	Shown as pending.
`pending_operator_approval`	Shown as pending.
`awaiting_approval`	Shown as pending.

Approval queue: history

Applies to: The operator approvals queue.

Value	Meaning
`approved`	Approved. Approve does not execute.
`rejected`	Rejected by a human.
`expired`	The window passed before use.
`revoked`	Revoked after approval, before use.

Spend envelope status

Applies to: The spend envelope minted at approval.

Value	Meaning
`approved`	Minted at human approval with the signed fields and scope.
`revoked`	Revoked. The signature is cleared and it can no longer be used.
`expired`	Past executableUntil.
`denied`	The approval was refused.

Approval ledger decision

Applies to: Approval ledger entries for spend envelopes.

Value	Meaning
`approved`	A human approved the draft; this ledger entry records the signed envelope alongside it.
`revoked`	The authorization was revoked by the owner or an admin.
`expired`	The envelope expired.
`denied`	The approval was refused.

Recurring mandate status

Applies to: Recurring mandates.

Value	Meaning
`active`	Cycles can be prepared. Each cycle still needs a fresh human approval.
`paused`	No cycles are prepared or claimed.
`cancelled`	Cancelled by the owner. No further cycles.
`completed`	No further cycles.

Mandate cycle status

Applies to: Each cycle of a recurring mandate.

Value	Meaning
`pending_approval`	Opened for this cycle and waiting for a fresh human approval.
`approved`	A fresh signed approval is attached. Claims before the cycle time are refused.
`claimed`	The claim was recorded. A claim never moves money.
`completed`	Reserved for execution, which is not enabled.
`refused`	Refused, for example after an execution attempt was recorded. The slot is used up.
`expired`	The cycle approval lapsed. The slot can be prepared again.
`skipped`	Skipped by the owner, or marked missed when a cycle is not approved and claimed by the cycle time plus grace.

Wallet connection status

Applies to: get_wallet_status.connectionStatus.

Value	Meaning
`not_connected`	No wallet is connected for this AI Agent.
`pending`	Wallet setup has started and is not verified yet.
`connected`	A staging wallet is connected and verified.
`unavailable`	Status cannot be read right now. See unavailableReason.
`error`	The last status check failed. See unavailableReason.

Wallet verification status

Applies to: get_wallet_status.verificationStatus.

Value	Meaning
`not_verified`	Not verified.
`pending`	Verification in progress.
`verified`	Verified.
`failed`	Verification failed.

Account module status

Applies to: get_account_status.modules[].status (including the wallet module).

Value	Meaning
`active`	The module is active.
`activating`	Activation is in progress.
`ready_to_connect`	Ready to connect.
`application_required`	An application is needed first.
`application_started`	An application was started.
`submitted`	The application was submitted.
`in_review`	Under review.
`action_required`	The account owner needs to act in POINTS, for example to re-authorize the wallet.
`not_approved`	Not approved.
`coming_soon`	Not available today. No date is published.
`temporarily_unavailable`	Temporarily unavailable.

Payment pattern

Applies to: prepare_payment.paymentPattern.

Requires execution (not enabled). Values exist in code only.

Value	Meaning
`standard`	A single payment draft.
`sell_side_job`	Escrow-before-work pattern.
`micropayment`	Fee-before-send, charge-on-2xx pattern.

Escrow state

Applies to: Escrow-before-work drafts.

Requires execution (not enabled). Values exist in code only.

Value	Meaning
`none`	No escrow hold.
`held`	Amount counted as escrowed.
`releasable`	Work accepted; the hold could be released.
`refundable`	The hold could be refunded.
`released`	Terminal: released.
`refunded`	Terminal: refunded.

Graduated autonomy level

Applies to: Agent Pay policy.

Requires execution (not enabled). Levels are computed and recorded for policy review. They never approve a payment. Every payment still needs human approval, and a level never overrides a policy deny, a block list, or a velocity cap.

Value	Meaning
`L0`	Lowest level: no history, a policy or list miss, or a velocity cap hit.
`L1`	Known or allow-listed merchant with thin history, small amounts.
`L2`	Good history and moderate frequency, larger amounts.
`L3`	Highest level: strong history and an allow-listed merchant.

Settlement terminal status

Applies to: Execution and settlement.

Requires execution (not enabled). Values exist in code only.

Value	Meaning
`completed`	Reserved for confirmed provider success.
`failed`	Reserved for a failed execution attempt.