Skip to main content

​
Endpoints

MethodEndpointDescription
GET/actions/:actionIdGet full action with all intents
GET/actions/:actionId/intents/:intentIndexGet specific intent
GET/actions/:actionId/intents/:intentIndex/steps/:stepIndexGet specific step

​
GET /actions/:actionId

Retrieve a complete action including all intents and their chain authorization steps.

​
Path Parameters

ParameterTypeRequiredDescription
actionIdstringYesAction ID (e.g., act_abc123...)

​
Response (200)

{
  "id": "act_abc123...",
  "user": "0x742d35Cc6634C0532925a3b844e4B7db0D6d8E5c",
  "status": "created",
  "intents": [
    {
      "id": "act_abc123.../0",
      "mode": "7702",
      "status": "created",
      "executionIndex": 0,
      "chainAuthorizations": [
        {
          "index": 0,
          "chainId": "84532",
          "status": "created",
          "mode": "7702"
        }
      ]
    }
  ]
}

​
GET /actions/:actionId/intents/:intentIndex

Retrieve a specific intent within an action.

​
Path Parameters

ParameterTypeRequiredDescription
actionIdstringYesAction ID
intentIndexnumberYesIntent index (0-based)

​
Response (200)

{
  "id": "act_abc123.../0",
  "actionId": "act_abc123...",
  "mode": "7702",
  "status": "created",
  "executionIndex": 0,
  "signatureType": "eip712",
  "signature": "0x...",
  "nbf": "0",
  "exp": "1999999999",
  "chainAuthorizations": [
    {
      "index": 0,
      "chainId": "84532",
      "status": "success",
      "txid": "0x...",
      "hash": "0x..."
    }
  ]
}

​
GET /actions/:actionId/intents/:intentIndex/steps/:stepIndex

Retrieve status of a specific chain authorization step.

​
Path Parameters

ParameterTypeRequiredDescription
actionIdstringYesAction ID
intentIndexnumberYesIntent index (0-based)
stepIndexnumberYesStep index (0-based)

​
Response (200)

{
  "intentId": "act_abc123.../0",
  "index": 0,
  "chainId": "84532",
  "mode": "7702",
  "status": "success",
  "hash": "0x...",
  "txid": "0xTransactionHash...",
  "txSentAt": "2024-01-15T10:30:00.000Z",
  "txConfirmedAt": "2024-01-15T10:30:15.000Z"
}

​
Step Status Values

StatusDescription
createdStep created, awaiting execution
registeredHash registered (non-7702:on-demand only)
executingTransaction sent, awaiting confirmation
successStep completed successfully
revertedTransaction reverted on-chain
errorExecution error occurred

​
Error Responses

​
400 Bad Request

{
  "error": "invalid params",
  "issues": { /* Validation errors */ }
}

​
404 Not Found

{
  "error": "could not find action",
  "actionId": "act_invalid..."
}

{
  "error": "could not find intent",
  "actionId": "act_abc123...",
  "intentIndex": 5
}

{
  "error": "could not find step",
  "actionId": "act_abc123...",
  "intentIndex": 0,
  "stepIndex": 10
}