Skip to main content
GET
/
v1
/
runs
curl "https://api.crewship.dev/v1/runs?deployment_id=dep_abc123xyz" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "runs": [
    {
      "id": "run_xyz789abc",
      "version_id": "ver_abc123xyz",
      "version_number": 3,
      "status": "succeeded",
      "created_at": "2024-01-15T10:35:00Z",
      "started_at": "2024-01-15T10:35:02Z",
      "completed_at": "2024-01-15T10:35:47Z"
    },
    {
      "id": "run_def456ghi",
      "version_id": "ver_abc123xyz",
      "version_number": 3,
      "status": "succeeded",
      "created_at": "2024-01-15T09:20:00Z",
      "started_at": "2024-01-15T09:20:01Z",
      "completed_at": "2024-01-15T09:21:12Z"
    }
  ]
}

​
Query Parameters

​
deployment_id
string
required
Deployment ID to list runs for

​
Response

​
runs
array
Array of run objects
Each run object contains:
​
runs[].id
string
Run ID
​
runs[].version_id
string
Version ID
​
runs[].version_number
integer
Version number
​
runs[].status
string
Run status: pending, running, succeeded, failed, canceled
​
runs[].created_at
string
When the run was created (ISO 8601)
​
runs[].started_at
string
When execution started (ISO 8601), or null
​
runs[].completed_at
string
When the run finished (ISO 8601), or null
curl "https://api.crewship.dev/v1/runs?deployment_id=dep_abc123xyz" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "runs": [
    {
      "id": "run_xyz789abc",
      "version_id": "ver_abc123xyz",
      "version_number": 3,
      "status": "succeeded",
      "created_at": "2024-01-15T10:35:00Z",
      "started_at": "2024-01-15T10:35:02Z",
      "completed_at": "2024-01-15T10:35:47Z"
    },
    {
      "id": "run_def456ghi",
      "version_id": "ver_abc123xyz",
      "version_number": 3,
      "status": "succeeded",
      "created_at": "2024-01-15T09:20:00Z",
      "started_at": "2024-01-15T09:20:01Z",
      "completed_at": "2024-01-15T09:21:12Z"
    }
  ]
}