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

{
  "data": [
    {
      "id": "run_xyz789abc",
      "deployment_id": "dep_abc123xyz",
      "project": "my-crew",
      "status": "succeeded",
      "created_at": "2024-01-15T10:35:00Z",
      "completed_at": "2024-01-15T10:35:47Z",
      "duration_ms": 45200
    },
    {
      "id": "run_def456ghi",
      "deployment_id": "dep_abc123xyz",
      "project": "my-crew",
      "status": "succeeded",
      "created_at": "2024-01-15T09:20:00Z",
      "completed_at": "2024-01-15T09:21:12Z",
      "duration_ms": 72000
    }
  ],
  "pagination": {
    "total": 156,
    "page": 1,
    "per_page": 20,
    "has_more": true
  }
}

​
Query Parameters

​
project
string
Filter by project name
​
deployment
string
Filter by deployment ID
​
status
string
Filter by status: pending, running, succeeded, failed, canceled
​
page
integer
default:"1"
Page number
​
per_page
integer
default:"20"
Items per page (max 100)

​
Response

​
data
array
Array of run objects
​
pagination
object
Pagination metadata
curl "https://api.crewship.dev/v1/runs?project=my-crew" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "data": [
    {
      "id": "run_xyz789abc",
      "deployment_id": "dep_abc123xyz",
      "project": "my-crew",
      "status": "succeeded",
      "created_at": "2024-01-15T10:35:00Z",
      "completed_at": "2024-01-15T10:35:47Z",
      "duration_ms": 45200
    },
    {
      "id": "run_def456ghi",
      "deployment_id": "dep_abc123xyz",
      "project": "my-crew",
      "status": "succeeded",
      "created_at": "2024-01-15T09:20:00Z",
      "completed_at": "2024-01-15T09:21:12Z",
      "duration_ms": 72000
    }
  ],
  "pagination": {
    "total": 156,
    "page": 1,
    "per_page": 20,
    "has_more": true
  }
}