List project contracts

Returns all non-deleted contracts for a project. Includes draft, active, completed, and terminated contracts. Line items are not modeled at the contract level — use the burn projection endpoint for consumption breakdown.

GET/api/v1/projects/:id/contracts

Authorization

financials:readapi key scoperequired

Required scope when calling with an API key.

project:contracts_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/contracts

curl -X GET "https://www.digitalstack360.com/api/v1/projects/proj_abc123/contracts" \
  -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": "contract-uuid-1",
      "project_id": "proj_abc123",
      "opportunity_id": "opp_abc123",
      "name": "Phase 1 SOW",
      "contract_number": "SOW-2026-001",
      "status": "active",
      "total_value": 250000,
      "start_date": "2026-05-01",
      "end_date": "2026-08-31",
      "currency": "USD",
      "created_at": "2026-05-01T10:00:00.000Z"
    },
    {
      "id": "contract-uuid-2",
      "project_id": "proj_abc123",
      "opportunity_id": null,
      "name": "Phase 2 Change Order",
      "contract_number": "CO-2026-004",
      "status": "draft",
      "total_value": 85000,
      "start_date": "2026-09-01",
      "end_date": "2026-11-30",
      "currency": "USD",
      "created_at": "2026-05-12T14:30:00.000Z"
    }
  ]
}

Errors

401

missing_auth

No credentials provided

401

invalid_api_key

API key is invalid or revoked

403

scope_insufficient

Key lacks financials:read scope

404

not_found

Project not found or not in your workspace