Skip to main content
GET
/
api
/
v1
/
contracts
/
stats
curl -H "X-API-Key: your_api_key_here" \
  "https://api.northaxiumdata.ca/api/v1/contracts/stats?group_by=department&department=National%20Defence&limit=10"

{
  "data": [
    {
      "group_by": "department",
      "group_value": "National Defence | Défense nationale",
      "record_count": 18432,
      "sum_field": "value",
      "sum_value": 4821034521.00
    },
    {
      "group_by": "department",
      "group_value": "Public Services and Procurement Canada | Services publics et Approvisionnement Canada",
      "record_count": 12891,
      "sum_field": "value",
      "sum_value": 3109823400.00
    }
  ],
  "meta": {
    "total": 482,
    "limit": 10,
    "offset": 0
  }
}

​
Overview

Returns grouped aggregate statistics across all federal contract records. Useful for spending breakdowns by department, vendor rankings by total value, or year-over-year procurement trends.

​
Query Parameters

​
group_by
string
Grouping dimension. Options: department, vendor, year. Default: department. Example: vendor.
​
sum_field
string
Only value. Default: value. Example: amount.
​
vendor
string
Partial match on vendor name. Example: Palantir.
​
department
string
Partial match on department name. Example: National Defence.
​
method
string
Exact match on procurement_method. Example: Non-competitive.
​
source
string
Exact match on source_dataset. Example: open.canada.
​
min_value
number
Minimum contract value. Example: 100000.
​
max_value
number
Maximum contract value. Example: 5000000.
​
date_from
string
ISO 8601 start date. Example: 2023-01-01.
​
date_to
string
ISO 8601 end date. Example: 2023-12-31.
​
limit
integer
Max groups to return. Default: 100. Max: 200. Example: 25.
​
offset
integer
Result offset. Default: 0. Example: 50.
curl -H "X-API-Key: your_api_key_here" \
  "https://api.northaxiumdata.ca/api/v1/contracts/stats?group_by=department&department=National%20Defence&limit=10"

{
  "data": [
    {
      "group_by": "department",
      "group_value": "National Defence | Défense nationale",
      "record_count": 18432,
      "sum_field": "value",
      "sum_value": 4821034521.00
    },
    {
      "group_by": "department",
      "group_value": "Public Services and Procurement Canada | Services publics et Approvisionnement Canada",
      "record_count": 12891,
      "sum_field": "value",
      "sum_value": 3109823400.00
    }
  ],
  "meta": {
    "total": 482,
    "limit": 10,
    "offset": 0
  }
}