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

# Get Run

> Retrieve a specific run by ID

## Path Parameters

<ParamField path="id" type="string" required>
  Run ID (e.g., `run_xyz789abc`)
</ParamField>

## Response

<ResponseField name="id" type="string">
  Run ID
</ResponseField>

<ResponseField name="version_id" type="string">
  Version ID
</ResponseField>

<ResponseField name="deployment_id" type="string">
  Deployment ID
</ResponseField>

<ResponseField name="status" type="string">
  Run status: `pending`, `running`, `succeeded`, `failed`, `canceled`
</ResponseField>

<ResponseField name="input" type="object">
  Input provided when creating the run
</ResponseField>

<ResponseField name="output" type="object">
  Final output (only present when succeeded)
</ResponseField>

<ResponseField name="error_message" type="string">
  Error message (only present when failed)
</ResponseField>

<ResponseField name="created_at" type="string">
  When the run was created (ISO 8601)
</ResponseField>

<ResponseField name="started_at" type="string">
  When execution started (ISO 8601), or `null`
</ResponseField>

<ResponseField name="completed_at" type="string">
  When the run finished (ISO 8601), or `null`
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.crewship.dev/v1/runs/run_xyz789abc \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Running theme={null}
  {
    "id": "run_xyz789abc",
    "version_id": "ver_abc123xyz",
    "deployment_id": "dep_abc123xyz",
    "status": "running",
    "input": {
      "topic": "AI agents"
    },
    "output": null,
    "error_message": null,
    "created_at": "2024-01-15T10:35:00Z",
    "started_at": "2024-01-15T10:35:02Z",
    "completed_at": null
  }
  ```

  ```json Succeeded theme={null}
  {
    "id": "run_xyz789abc",
    "version_id": "ver_abc123xyz",
    "deployment_id": "dep_abc123xyz",
    "status": "succeeded",
    "input": {
      "topic": "AI agents"
    },
    "output": {
      "result": "Generated report about AI agents..."
    },
    "error_message": null,
    "created_at": "2024-01-15T10:35:00Z",
    "started_at": "2024-01-15T10:35:02Z",
    "completed_at": "2024-01-15T10:35:47Z"
  }
  ```

  ```json Failed theme={null}
  {
    "id": "run_xyz789abc",
    "version_id": "ver_abc123xyz",
    "deployment_id": "dep_abc123xyz",
    "status": "failed",
    "input": {
      "topic": "AI agents"
    },
    "output": null,
    "error_message": "OpenAI API rate limit exceeded",
    "created_at": "2024-01-15T10:35:00Z",
    "started_at": "2024-01-15T10:35:02Z",
    "completed_at": "2024-01-15T10:35:05Z"
  }
  ```
</ResponseExample>