> ## Documentation Index
> Fetch the complete documentation index at: https://docs.northaxiumdata.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# Procurement Lifecycle

> Full tender → award → contract chain linked by solicitation number.

## Overview

Returns all procurement events — tender notices, award notices, and contracts — linked by a common `solicitation_number`. Use this to trace the full lifecycle of a competitive procurement from open tender through to final contract award.

<Note>
  Solicitation number coverage is approximately 4% of total procurement records. Many contracts in the TBS disclosure dataset do not carry a solicitation number in the source data.
</Note>

## Path Parameters

<ParamField path="solicitation_number" type="string" required>
  The solicitation number to look up — e.g. `PS23-AG-004`. Example: `WS345678`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "X-API-Key: your_api_key_here" \
    "https://api.northaxiumdata.ca/api/v1/procurement/PS23-AG-004"
  ```

  ```python Python theme={null}
  import requests

  headers = {"X-API-Key": "your_api_key_here"}
  solicitation = "PS23-AG-004"

  response = requests.get(
      f"https://api.northaxiumdata.ca/api/v1/procurement/{solicitation}",
      headers=headers
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": {
      "solicitation_number": "PS23-AG-004",
      "tender": {
        "record_id": "tender_abc",
        "event_type": "tender",
        "date": "2023-03-15",
        "department": "Public Services and Procurement Canada"
      },
      "awards": [
        {
          "record_id": "award_xyz",
          "event_type": "award",
          "vendor": "Acme Government Solutions Inc",
          "value": 450000.00,
          "date": "2023-04-02"
        }
      ],
      "contracts": [
        {
          "record_id": "contract_123",
          "event_type": "contract",
          "vendor": "Acme Government Solutions Inc",
          "value": 450000.00,
          "date": "2023-04-15"
        }
      ]
    }
  }
  ```

  ```json 404 theme={null}
  {
    "error": {
      "code": "NOT_FOUND",
      "message": "Procurement lifecycle not found."
    }
  }
  ```

  ```json 401 theme={null}
  {
    "error": {
      "code": "UNAUTHORIZED",
      "message": "Missing API key. Pass your key in the X-API-Key header."
    }
  }
  ```

  ```json 429 theme={null}
  {
    "error": {
      "code": "RATE_LIMITED",
      "message": "Monthly request limit exceeded. Upgrade your plan for higher limits."
    }
  }
  ```
</ResponseExample>