List project phases

Returns all phases for a project in order. Each phase includes its H2.0 delivery classification tag and an is_standard_phase flag that distinguishes canonical lifecycle phases from custom-named phases.

GET/api/v1/projects/:id/phases

Authorization

projects:readapi key scoperequired

Required scope when calling with an API key.

project:timeline_readsession capabilityoptional

Required capability when calling with a signed-in session.

Path parameters

idstringrequired

Project ID

Example: proj_abc123

Request

GET /api/v1/projects/:id/phases

curl -X GET "https://www.digitalstack360.com/api/v1/projects/proj_abc123/phases" \
  -H "Authorization: Bearer $DS_API_KEY"

Examples use a placeholder key from your environment. Store your key in $DS_API_KEY — never commit it.

Response

200 OK

{
  "data": [
    {
      "id": "phase-uuid-1",
      "project_id": "proj_abc123",
      "name": "Discovery",
      "slug": "discovery",
      "status": "completed",
      "delivery_phase": "discovery",
      "is_standard_phase": true,
      "contract_id": "contract-uuid-1",
      "start_date": "2026-01-10",
      "end_date": "2026-02-14",
      "order_index": 0,
      "created_at": "2026-01-01T00:00:00.000Z"
    },
    {
      "id": "phase-uuid-2",
      "project_id": "proj_abc123",
      "name": "Design & Prototyping",
      "slug": "design-prototyping",
      "status": "in_progress",
      "delivery_phase": "design",
      "is_standard_phase": true,
      "contract_id": "contract-uuid-1",
      "start_date": "2026-02-17",
      "end_date": "2026-03-28",
      "order_index": 1,
      "created_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks projects:read scope

404

not_found

Project not found or not in your workspace