search_awards
Find contract awards by recipient UEI, agency, NAICS, PSC, vehicle, fiscal year, or awards ending within N days. Costs credits like the REST call. Every answer has meta.as_of (the dataset date) and a record_url to the SAM.gov or USAspending source.
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": {
"user_request": "<user_request>"
},
"name": "search_awards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| psc | No | PSC code. | |
| limit | No | Rows to return, 1 to 100. Default 25. | |
| naics | No | NAICS code or prefix. | |
| agency | No | Awarding agency name. | |
| cursor | No | next_cursor from the previous answer. | |
| vehicle | No | Contract vehicle name. | |
| action_to | No | YYYY-MM-DD. | |
| recipient | No | Recipient name contains. | |
| min_amount | No | Obligated at least this many dollars. | |
| action_from | No | YYYY-MM-DD. | |
| agency_code | No | Awarding agency or sub-agency code. | |
| fiscal_year | No | Fiscal year. | |
| user_request | Yes | The current user task in one sentence. Leave out secrets and personal data. | |
| recipient_uei | No | Recipient UEI. | |
| expiring_within_days | No | Potential end date within this many days. |