Summarize contract awards
summarize_awardsCount award notices and sum their Canadian-dollar values by supplier, buyer, or award year using procurement filters, so you can rank suppliers, profile buyers, or track spending over time.
Instructions
Count award notices and total their value by supplier, buyer or award year, using the same filters as search_awards. Use it to rank the suppliers winning a kind of work, see which organizations buy it, profile one supplier or buyer, or follow spending over time. Totals add Canadian-dollar values only and are indicative: standing offers and supply arrangements have no value, a supplier spelled two ways counts as two, and values are as last amended. The buyer is the contracting organization, often Public Services and Procurement Canada acting for another department.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"group_by": "<group_by>"
},
"name": "summarize_awards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Output language. | en |
| sort | No | Rank by total Canadian-dollar value or by number of awards. Years are always listed newest first. | total_value |
| buyer | No | Words from the contracting or end-user organization name, in either language. Public Services and Procurement Canada buys on behalf of other departments, which then appear as end users. | |
| limit | No | Results per page (1-50). | |
| match | No | Whether a notice must contain all query terms or any of them. An explicit OR in the query always applies. | all |
| query | No | Keywords searched in titles, descriptions, commodity names, supplier and buyer names, and solicitation and contract numbers. Words match in English and French, ignoring case and accents. Use "double quotes" for an exact phrase, a trailing * for a prefix (engineer*), and uppercase OR between alternatives. | |
| offset | No | Results to skip, for paging. | |
| region | No | Text contained in a region of delivery, e.g. "Ontario" or "National Capital Region". | |
| unspsc | No | UNSPSC commodity code or prefix. A segment or family code such as 43000000 or 4323 also matches every code beneath it. | |
| category | No | Procurement categories; an award matching any listed category is returned. | |
| group_by | Yes | What each row of the summary is. | |
| supplier | No | Words from the winning supplier's legal name, e.g. "Deloitte". | |
| max_value | No | Only awards with a stated value of at most this amount. | |
| min_value | No | Only awards worth at least this amount, in the contract currency (almost always CAD). Above zero, this drops awards with no stated value. | |
| competitive | No | true for competitively awarded contracts only; false for non-competitive awards and advance contract award notices only. Awards with no stated method match neither. | |
| awarded_after | No | Only contracts awarded on or after this date (YYYY-MM-DD). | |
| awarded_before | No | Only contracts awarded on or before this date (YYYY-MM-DD). | |
| include_cancelled | No | Also return cancelled award notices. |