# Get Execution Details

`GET /api/v1/logs/executions/{executionId}`

## Description
Retrieve the full execution state snapshot, including the workflow state at time of execution and detailed metadata.

## Parameters

- **executionId** (path) (required) — `string`: The unique execution identifier.

## Responses

### 200 — Full execution state snapshot with workflow state and metadata.

```json
{
  "type": "object",
  "properties": {
    "executionId": {
      "type": "string",
      "description": "The unique identifier for this execution."
    },
    "workflowId": {
      "type": "string",
      "description": "The workflow that was executed."
    },
    "workflowState": {
      "type": "object",
      "description": "Snapshot of the workflow configuration at the time of execution.",
      "properties": {
        "blocks": {
          "type": "object",
          "description": "Map of block IDs to their configuration and state during execution."
        },
        "edges": {
          "type": "array",
          "description": "List of connections between blocks defining the execution flow.",
          "items": {
            "type": "object"
          }
        },
        "loops": {
          "type": "object",
          "description": "Loop configurations defining iterative execution patterns."
        },
        "parallels": {
          "type": "object",
          "description": "Parallel execution group configurations."
        }
      }
    },
    "executionMetadata": {
      "type": "object",
      "description": "Metadata about the execution including timing and cost information.",
      "properties": {
        "trigger": {
          "type": "string",
          "description": "How the execution was triggered (e.g., api, manual, schedule)."
        },
        "startedAt": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601 timestamp when execution started."
        },
        "endedAt": {
          "type": "string",
          "format": "date-time",
          "description": "ISO 8601 timestamp when execution completed."
        },
        "totalDurationMs": {
          "type": "integer",
          "description": "Total execution duration in milliseconds."
        },
        "cost": {
          "type": "object",
          "description": "Cost breakdown for this execution including per-model details."
        }
      }
    },
    "limits": {
      "type": "object",
      "description": "Rate limit and usage information attached to the /api/v1 workflows, logs, and audit logs responses. The Execute Workflow and Get Job Status responses do not include it.",
      "properties": {
        "workflowExecutionRateLimit": {
          "type": "object",
          "description": "Current rate limit status for workflow executions.",
          "properties": {
            "sync": {
              "description": "Rate limit bucket for synchronous executions.",
              "$ref": "#/components/schemas/RateLimitBucket"
            },
            "async": {
              "description": "Rate limit bucket for asynchronous executions.",
              "$ref": "#/components/schemas/RateLimitBucket"
            }
          }
        },
        "usage": {
          "type": "object",
          "description": "Current billing period usage and plan limits.",
          "properties": {
            "currentPeriodCost": {
              "type": "number",
              "description": "Total spend in the current billing period in USD.",
              "example": 1.25
            },
            "limit": {
              "type": "number",
              "description": "Maximum allowed spend for the current billing period in USD.",
              "example": 50
            },
            "plan": {
              "type": "string",
              "description": "Your current subscription plan (e.g., free, pro, team).",
              "example": "pro"
            },
            "isExceeded": {
              "type": "boolean",
              "description": "Whether the usage limit has been exceeded. Executions may be blocked when true.",
              "example": false
            }
          }
        }
      }
    }
  }
}
```

### 401 — Invalid or missing API key. Ensure the X-API-Key header is set with a valid key.

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Human-readable error message."
    }
  }
}
```

### 404 — The requested resource was not found. Verify the ID is correct and belongs to your workspace.

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Human-readable error message."
    }
  }
}
```

### 429 — Rate limit exceeded. Wait for the duration specified in the Retry-After header before retrying.

```json
{
  "type": "object",
  "properties": {
    "error": {
      "type": "string",
      "description": "Human-readable error message with rate limit details."
    }
  }
}
```
