Skip to main content
GET
Query Async Action Status
Poll the status of a long-running asynchronous action such as a cross-chain bridge transfer. When you execute a bridge via POST /v1/actions/bridge, the server returns a 202 Accepted response with an auditId. Use this endpoint to poll for the final result.

Status Values

Authorizations

Authorization
string
header
required

Provide raw API session token issued by /v1/connect/complete

Headers

X-Aegis-Email
string
required

Agent email address

Path Parameters

auditId
string<uuid>
required

The auditId returned from the async action (e.g. bridge)

Response

Action status retrieved

success
boolean
action
string
Example:

"CCTP_BRIDGE_USDC"

status
enum<string>

Current status of the background task

Available options:
PENDING,
PROCESSING,
SUCCESS,
FAILED
txHash
string | null

Transaction hash, available when status is SUCCESS

error
string | null

Error message, available when status is FAILED

createdAt
string<date-time>
updatedAt
string<date-time>