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

# TBS Disclosures

> TBS proactive disclosure contract records from open.canada.ca.

## Overview

Returns Treasury Board of Canada Secretariat (TBS) proactive disclosure records — the government's mandatory public reporting of contracts over \$10,000. Accepts the same filter parameters as the main contracts endpoint.

## Query Parameters

<ParamField query="vendor" type="string">
  Partial match on vendor name. Example: `Palantir`.
</ParamField>

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

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

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

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

<ParamField query="date_to" type="string">
  ISO 8601 end date. 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>

<Note>
  `page` and `per_page` are accepted as input aliases. `per_page` maps to `limit`, and `page` is converted internally into the corresponding `offset`.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl -H "X-API-Key: your_api_key_here" \
    "https://api.northaxiumdata.ca/api/v1/disclosures?department=National%20Defence&limit=10&offset=10"
  ```

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

  headers = {"X-API-Key": "your_api_key_here"}
  params = {"department": "National Defence", "limit": 10, "offset": 10}

  response = requests.get(
      "https://api.northaxiumdata.ca/api/v1/disclosures",
      headers=headers,
      params=params
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "record_id": "def456abc",
        "vendor": "Lockheed Martin Canada Inc",
        "department": "National Defence | Défense nationale",
        "value": 8430000.00,
        "date": "2023-09-30",
        "source_dataset": "open.canada contracts (PP-Contracts)"
      }
    ],
    "meta": {
      "total": 550306,
      "limit": 10,
      "offset": 10
    }
  }
  ```

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