> ## 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.

# Award Notices

> Search federal award notices from CanadaBuys.

## Overview

Returns federal award notices — announcements of contract awards published on CanadaBuys. Award notices are published after a tender closes and before the final contract is signed, making them useful for early signal on who won a competition.

For the full procurement lifecycle linking an award to its tender and contract, use the [Procurement Lifecycle](/api-reference/contracts/lifecycle) endpoint. For final signed contracts, use [List Contracts](/api-reference/contracts/list).

Single award records are available at `GET /api/v1/awards/{record_id}`.

## Query Parameters

<ParamField query="vendor" type="string">
  Partial match on vendor name (case-insensitive). Example: `Palantir`.
</ParamField>

<ParamField query="department" type="string">
  Partial match on department name (case-insensitive). Example: `National Defence`.
</ParamField>

<ParamField query="method" type="string">
  Exact match on `procurement_method` field. Example: `Non-competitive`.
</ParamField>

<ParamField query="source" type="string">
  Exact match on `source_dataset` field. Example: `open.canada`.
</ParamField>

<ParamField query="min_value" type="number">
  Minimum award value in CAD. Example: `100000`.
</ParamField>

<ParamField query="max_value" type="number">
  Maximum award value in CAD. Example: `5000000`.
</ParamField>

<ParamField query="date_from" type="string">
  ISO 8601 start date — e.g. `2023-01-01`. Example: `2023-01-01`.
</ParamField>

<ParamField query="date_to" type="string">
  ISO 8601 end date — e.g. `2023-12-31`. Example: `2023-12-31`.
</ParamField>

<ParamField query="limit" type="integer">
  Results per page. Default: `50`. Max: `200`. Example: `25`.
</ParamField>

<ParamField query="offset" type="integer">
  Result offset for pagination. Default: `0`. Example: `50`.
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "X-API-Key: your_api_key_here" \
    "https://api.northaxiumdata.ca/api/v1/awards?vendor=SNC-Lavalin&limit=10"
  ```

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

  headers = {"X-API-Key": "your_api_key_here"}
  params = {"vendor": "SNC-Lavalin", "limit": 10}

  response = requests.get(
      "https://api.northaxiumdata.ca/api/v1/awards",
      headers=headers,
      params=params
  )
  for award in response.json()["data"]:
      print(f"{award['date']} — {award['vendor']}: ${award['value']:,.0f}")
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    "https://api.northaxiumdata.ca/api/v1/awards?vendor=SNC-Lavalin&limit=10",
    { headers: { "X-API-Key": "your_api_key_here" } }
  );
  const data = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "record_id": "award_xyz456",
        "event_type": "award",
        "vendor": "SNC-Lavalin Inc",
        "department": "Public Services and Procurement Canada | Services publics et Approvisionnement Canada",
        "value": 4200000.00,
        "date": "2023-09-12",
        "description": "Award notice for engineering services",
        "procurement_method": "Competitive",
        "source_dataset": "CanadaBuys Awards",
        "solicitation_number": "EP474-23ABC",
        "source_url": "https://buyandsell.gc.ca/..."
      }
    ],
    "meta": {
      "total": 130000,
      "limit": 10,
      "offset": 0
    }
  }
  ```

  ```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>