> ## Documentation Index
> Fetch the complete documentation index at: https://spiceflow-docs.spicenet.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GET Action & Intent Status

> Retrieve action, intent, or step status for tracking execution progress

## Endpoints

| Method | Endpoint                                                   | Description                      |
| ------ | ---------------------------------------------------------- | -------------------------------- |
| `GET`  | `/actions/:actionId`                                       | Get full action with all intents |
| `GET`  | `/actions/:actionId/intents/:intentIndex`                  | Get specific intent              |
| `GET`  | `/actions/:actionId/intents/:intentIndex/steps/:stepIndex` | Get specific step                |

***

## GET /actions/:actionId

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

### Path Parameters

| Parameter  | Type     | Required | Description                       |
| ---------- | -------- | -------- | --------------------------------- |
| `actionId` | `string` | Yes      | Action ID (e.g., `act_abc123...`) |

### Response (200)

```json theme={null}
{
  "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

| Parameter     | Type     | Required | Description            |
| ------------- | -------- | -------- | ---------------------- |
| `actionId`    | `string` | Yes      | Action ID              |
| `intentIndex` | `number` | Yes      | Intent index (0-based) |

### Response (200)

```json theme={null}
{
  "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

| Parameter     | Type     | Required | Description            |
| ------------- | -------- | -------- | ---------------------- |
| `actionId`    | `string` | Yes      | Action ID              |
| `intentIndex` | `number` | Yes      | Intent index (0-based) |
| `stepIndex`   | `number` | Yes      | Step index (0-based)   |

### Response (200)

```json theme={null}
{
  "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

| Status       | Description                               |
| ------------ | ----------------------------------------- |
| `created`    | Step created, awaiting execution          |
| `registered` | Hash registered (non-7702:on-demand only) |
| `executing`  | Transaction sent, awaiting confirmation   |
| `success`    | Step completed successfully               |
| `reverted`   | Transaction reverted on-chain             |
| `error`      | Execution error occurred                  |

***

## Error Responses

### 400 Bad Request

```json theme={null}
{
  "error": "invalid params",
  "issues": { /* Validation errors */ }
}
```

### 404 Not Found

```json theme={null}
{
  "error": "could not find action",
  "actionId": "act_invalid..."
}
```

```json theme={null}
{
  "error": "could not find intent",
  "actionId": "act_abc123...",
  "intentIndex": 5
}
```

```json theme={null}
{
  "error": "could not find step",
  "actionId": "act_abc123...",
  "intentIndex": 0,
  "stepIndex": 10
}
```