Get contract

Returns a single contract by ID, including project name. Workspace-isolated: returns 404 for contracts in other workspaces. Soft-deleted contracts are not visible.

GET/api/v1/contracts/:id

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

Contract ID

Example: contract-uuid-1

Request

GET /api/v1/contracts/:id

curl -X GET "https://www.digitalstack360.com/api/v1/contracts/contract-uuid-1" \
  -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",
    "project_name": "Website Replatform",
    "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"
  }
}

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

Contract not found or not in your workspace