Get a federal award
curl --request POST \
--url https://api.plyne.ai/v1/tools/usaspending_award/execute \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"target": "CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-"
}
'import requests
url = "https://api.plyne.ai/v1/tools/usaspending_award/execute"
payload = { "target": "CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-" }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({target: 'CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-'})
};
fetch('https://api.plyne.ai/v1/tools/usaspending_award/execute', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.plyne.ai/v1/tools/usaspending_award/execute",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'target' => 'CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.plyne.ai/v1/tools/usaspending_award/execute"
payload := strings.NewReader("{\n \"target\": \"CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.plyne.ai/v1/tools/usaspending_award/execute")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"target\": \"CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.plyne.ai/v1/tools/usaspending_award/execute")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"target\": \"CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"platform": "usaspending",
"record": {
"generated_unique_award_id": "<string>",
"id": 123,
"@type": "UsaspendingAward",
"awarding_agency": {
"@type": "UsaspendingAgencyRef",
"id": 123,
"office_agency_name": "<string>",
"subtier_abbreviation": "<string>",
"subtier_code": "<string>",
"subtier_name": "<string>",
"toptier_abbreviation": "<string>",
"toptier_code": "<string>",
"toptier_name": "<string>",
"toptier_slug": "<string>"
},
"base_and_all_options": 123,
"base_exercised_options": 123,
"category": "<string>",
"cfda_info": [],
"date_signed": 123,
"description": "<string>",
"executive_officers": [],
"fain": "<string>",
"funding_agency": {
"@type": "UsaspendingAgencyRef",
"id": 123,
"office_agency_name": "<string>",
"subtier_abbreviation": "<string>",
"subtier_code": "<string>",
"subtier_name": "<string>",
"toptier_abbreviation": "<string>",
"toptier_code": "<string>",
"toptier_name": "<string>",
"toptier_slug": "<string>"
},
"funding_opportunity_goals": "<string>",
"funding_opportunity_number": "<string>",
"latest_transaction_contract_data": {
"@type": "UsaspendingContractData",
"clinger_cohen_act_planning": "<string>",
"clinger_cohen_act_planning_description": "<string>",
"commercial_item_acquisition": "<string>",
"commercial_item_acquisition_description": "<string>",
"commercial_item_test_program": "<string>",
"commercial_item_test_program_description": "<string>",
"consolidated_contract": "<string>",
"consolidated_contract_description": "<string>",
"construction_wage_rate": "<string>",
"construction_wage_rate_description": "<string>",
"cost_or_pricing_data": "<string>",
"cost_or_pricing_data_description": "<string>",
"dod_acquisition_program": "<string>",
"dod_acquisition_program_description": "<string>",
"dod_claimant_program": "<string>",
"dod_claimant_program_description": "<string>",
"domestic_or_foreign_entity": "<string>",
"domestic_or_foreign_entity_description": "<string>",
"evaluated_preference": "<string>",
"evaluated_preference_description": "<string>",
"extent_competed": "<string>",
"extent_competed_description": "<string>",
"fair_opportunity_limited": "<string>",
"fair_opportunity_limited_description": "<string>",
"fed_biz_opps": "<string>",
"fed_biz_opps_description": "<string>",
"foreign_funding": "<string>",
"foreign_funding_description": "<string>",
"idv_type_description": "<string>",
"information_technology_commercial_item_category": "<string>",
"information_technology_commercial_item_category_description": "<string>",
"interagency_contracting_authority": "<string>",
"interagency_contracting_authority_description": "<string>",
"labor_standards": "<string>",
"labor_standards_description": "<string>",
"major_program": "<string>",
"materials_supplies": "<string>",
"materials_supplies_description": "<string>",
"multi_year_contract": "<string>",
"multi_year_contract_description": "<string>",
"multiple_or_single_award_description": "<string>",
"naics": "<string>",
"naics_description": "<string>",
"national_interest_action": "<string>",
"national_interest_action_description": "<string>",
"number_of_offers_received": "<string>",
"other_than_full_and_open": "<string>",
"other_than_full_and_open_description": "<string>",
"price_evaluation_adjustment": 123,
"product_or_service_code": "<string>",
"product_or_service_description": "<string>",
"program_acronym": "<string>",
"purchase_card_as_payment_method": "<string>",
"purchase_card_as_payment_method_description": "<string>",
"referenced_idv_agency_desc": "<string>",
"referenced_idv_agency_iden": "<string>",
"sea_transportation": "<string>",
"sea_transportation_description": "<string>",
"small_business_competitive": true,
"solicitation_identifier": "<string>",
"solicitation_procedures": "<string>",
"solicitation_procedures_description": "<string>",
"subcontracting_plan": "<string>",
"subcontracting_plan_description": "<string>",
"type_of_contract_pricing": "<string>",
"type_of_contract_pricing_description": "<string>",
"type_of_idc_description": "<string>",
"type_set_aside": "<string>",
"type_set_aside_description": "<string>"
},
"naics": "<string>",
"naics_description": "<string>",
"naics_hierarchy": {
"@type": "UsaspendingCodeHierarchy",
"midtier_code": "<string>",
"midtier_description": "<string>",
"toptier_code": "<string>",
"toptier_description": "<string>"
},
"parent_award": {
"generated_unique_award_id": "<string>",
"@type": "UsaspendingParentAward",
"agency_id": 123,
"agency_name": "<string>",
"agency_slug": "<string>",
"id": 123,
"idv_type_description": "<string>",
"multiple_or_single_award_description": "<string>",
"piid": "<string>",
"sub_agency_id": "<string>",
"sub_agency_name": "<string>",
"type_of_idc_description": "<string>"
},
"period_of_performance": {
"@type": "UsaspendingPeriodOfPerformance",
"end_date": 123,
"last_modified_date": 123,
"potential_end_date": 123,
"start_date": 123
},
"piid": "<string>",
"place_of_performance": {
"@type": "UsaspendingLocation",
"address_line1": "<string>",
"address_line2": "<string>",
"city_name": "<string>",
"congressional_code": "<string>",
"country_code": "<string>",
"country_name": "<string>",
"county_code": "<string>",
"county_name": "<string>",
"foreign_postal_code": "<string>",
"foreign_province": "<string>",
"state_code": "<string>",
"state_name": "<string>",
"zip4": "<string>",
"zip5": "<string>"
},
"psc": "<string>",
"psc_description": "<string>",
"psc_hierarchy": {
"@type": "UsaspendingCodeHierarchy",
"midtier_code": "<string>",
"midtier_description": "<string>",
"toptier_code": "<string>",
"toptier_description": "<string>"
},
"recipient": {
"@type": "UsaspendingAwardRecipient",
"business_categories": [],
"location": {
"@type": "UsaspendingLocation",
"address_line1": "<string>",
"address_line2": "<string>",
"city_name": "<string>",
"congressional_code": "<string>",
"country_code": "<string>",
"country_name": "<string>",
"county_code": "<string>",
"county_name": "<string>",
"foreign_postal_code": "<string>",
"foreign_province": "<string>",
"state_code": "<string>",
"state_name": "<string>",
"zip4": "<string>",
"zip5": "<string>"
},
"name": "<string>",
"parent_name": "<string>",
"parent_recipient_hash": "<string>",
"parent_uei": "<string>",
"recipient_hash": "<string>",
"uei": "<string>"
},
"record_type": 123,
"subaward_count": 0,
"total_loan_value": 123,
"total_obligation": 123,
"total_outlay": 123,
"total_subaward_amount": 123,
"total_subsidy_cost": 123,
"type": "<string>",
"type_description": "<string>",
"uri": "<string>"
}
},
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"id": "<string>",
"sources": [
{
"provider": "<string>",
"observation_id": "<string>",
"observed_at": "2023-11-07T05:31:56Z",
"url": "<string>"
}
],
"status": "completed",
"tool": "usaspending_award",
"usage": {
"credit_units": 1,
"credits": "<string>",
"unit": "request"
},
"version": "1",
"fulfillment": {
"field_sources": {},
"missing_fields": [
"<string>"
],
"satisfied": true
},
"routing": {
"mode": "auto",
"attempts": [
{
"outcome": "success",
"provider": "<string>",
"requests": 1
}
],
"selected_provider": "<string>"
},
"warnings": [
{
"code": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>"
}Buying & procurement
Get a federal award
Call usaspending_award through the Plyne API or MCP. Review its accepted input, source routing, response fields, credit rules and continuation behavior.
POST
/
v1
/
tools
/
usaspending_award
/
execute
Get a federal award
curl --request POST \
--url https://api.plyne.ai/v1/tools/usaspending_award/execute \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"target": "CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-"
}
'import requests
url = "https://api.plyne.ai/v1/tools/usaspending_award/execute"
payload = { "target": "CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-" }
headers = {
"Idempotency-Key": "<idempotency-key>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Idempotency-Key': '<idempotency-key>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({target: 'CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-'})
};
fetch('https://api.plyne.ai/v1/tools/usaspending_award/execute', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.plyne.ai/v1/tools/usaspending_award/execute",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'target' => 'CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"Idempotency-Key: <idempotency-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.plyne.ai/v1/tools/usaspending_award/execute"
payload := strings.NewReader("{\n \"target\": \"CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Idempotency-Key", "<idempotency-key>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.plyne.ai/v1/tools/usaspending_award/execute")
.header("Idempotency-Key", "<idempotency-key>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"target\": \"CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.plyne.ai/v1/tools/usaspending_award/execute")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"target\": \"CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-\"\n}"
response = http.request(request)
puts response.read_body{
"data": {
"platform": "usaspending",
"record": {
"generated_unique_award_id": "<string>",
"id": 123,
"@type": "UsaspendingAward",
"awarding_agency": {
"@type": "UsaspendingAgencyRef",
"id": 123,
"office_agency_name": "<string>",
"subtier_abbreviation": "<string>",
"subtier_code": "<string>",
"subtier_name": "<string>",
"toptier_abbreviation": "<string>",
"toptier_code": "<string>",
"toptier_name": "<string>",
"toptier_slug": "<string>"
},
"base_and_all_options": 123,
"base_exercised_options": 123,
"category": "<string>",
"cfda_info": [],
"date_signed": 123,
"description": "<string>",
"executive_officers": [],
"fain": "<string>",
"funding_agency": {
"@type": "UsaspendingAgencyRef",
"id": 123,
"office_agency_name": "<string>",
"subtier_abbreviation": "<string>",
"subtier_code": "<string>",
"subtier_name": "<string>",
"toptier_abbreviation": "<string>",
"toptier_code": "<string>",
"toptier_name": "<string>",
"toptier_slug": "<string>"
},
"funding_opportunity_goals": "<string>",
"funding_opportunity_number": "<string>",
"latest_transaction_contract_data": {
"@type": "UsaspendingContractData",
"clinger_cohen_act_planning": "<string>",
"clinger_cohen_act_planning_description": "<string>",
"commercial_item_acquisition": "<string>",
"commercial_item_acquisition_description": "<string>",
"commercial_item_test_program": "<string>",
"commercial_item_test_program_description": "<string>",
"consolidated_contract": "<string>",
"consolidated_contract_description": "<string>",
"construction_wage_rate": "<string>",
"construction_wage_rate_description": "<string>",
"cost_or_pricing_data": "<string>",
"cost_or_pricing_data_description": "<string>",
"dod_acquisition_program": "<string>",
"dod_acquisition_program_description": "<string>",
"dod_claimant_program": "<string>",
"dod_claimant_program_description": "<string>",
"domestic_or_foreign_entity": "<string>",
"domestic_or_foreign_entity_description": "<string>",
"evaluated_preference": "<string>",
"evaluated_preference_description": "<string>",
"extent_competed": "<string>",
"extent_competed_description": "<string>",
"fair_opportunity_limited": "<string>",
"fair_opportunity_limited_description": "<string>",
"fed_biz_opps": "<string>",
"fed_biz_opps_description": "<string>",
"foreign_funding": "<string>",
"foreign_funding_description": "<string>",
"idv_type_description": "<string>",
"information_technology_commercial_item_category": "<string>",
"information_technology_commercial_item_category_description": "<string>",
"interagency_contracting_authority": "<string>",
"interagency_contracting_authority_description": "<string>",
"labor_standards": "<string>",
"labor_standards_description": "<string>",
"major_program": "<string>",
"materials_supplies": "<string>",
"materials_supplies_description": "<string>",
"multi_year_contract": "<string>",
"multi_year_contract_description": "<string>",
"multiple_or_single_award_description": "<string>",
"naics": "<string>",
"naics_description": "<string>",
"national_interest_action": "<string>",
"national_interest_action_description": "<string>",
"number_of_offers_received": "<string>",
"other_than_full_and_open": "<string>",
"other_than_full_and_open_description": "<string>",
"price_evaluation_adjustment": 123,
"product_or_service_code": "<string>",
"product_or_service_description": "<string>",
"program_acronym": "<string>",
"purchase_card_as_payment_method": "<string>",
"purchase_card_as_payment_method_description": "<string>",
"referenced_idv_agency_desc": "<string>",
"referenced_idv_agency_iden": "<string>",
"sea_transportation": "<string>",
"sea_transportation_description": "<string>",
"small_business_competitive": true,
"solicitation_identifier": "<string>",
"solicitation_procedures": "<string>",
"solicitation_procedures_description": "<string>",
"subcontracting_plan": "<string>",
"subcontracting_plan_description": "<string>",
"type_of_contract_pricing": "<string>",
"type_of_contract_pricing_description": "<string>",
"type_of_idc_description": "<string>",
"type_set_aside": "<string>",
"type_set_aside_description": "<string>"
},
"naics": "<string>",
"naics_description": "<string>",
"naics_hierarchy": {
"@type": "UsaspendingCodeHierarchy",
"midtier_code": "<string>",
"midtier_description": "<string>",
"toptier_code": "<string>",
"toptier_description": "<string>"
},
"parent_award": {
"generated_unique_award_id": "<string>",
"@type": "UsaspendingParentAward",
"agency_id": 123,
"agency_name": "<string>",
"agency_slug": "<string>",
"id": 123,
"idv_type_description": "<string>",
"multiple_or_single_award_description": "<string>",
"piid": "<string>",
"sub_agency_id": "<string>",
"sub_agency_name": "<string>",
"type_of_idc_description": "<string>"
},
"period_of_performance": {
"@type": "UsaspendingPeriodOfPerformance",
"end_date": 123,
"last_modified_date": 123,
"potential_end_date": 123,
"start_date": 123
},
"piid": "<string>",
"place_of_performance": {
"@type": "UsaspendingLocation",
"address_line1": "<string>",
"address_line2": "<string>",
"city_name": "<string>",
"congressional_code": "<string>",
"country_code": "<string>",
"country_name": "<string>",
"county_code": "<string>",
"county_name": "<string>",
"foreign_postal_code": "<string>",
"foreign_province": "<string>",
"state_code": "<string>",
"state_name": "<string>",
"zip4": "<string>",
"zip5": "<string>"
},
"psc": "<string>",
"psc_description": "<string>",
"psc_hierarchy": {
"@type": "UsaspendingCodeHierarchy",
"midtier_code": "<string>",
"midtier_description": "<string>",
"toptier_code": "<string>",
"toptier_description": "<string>"
},
"recipient": {
"@type": "UsaspendingAwardRecipient",
"business_categories": [],
"location": {
"@type": "UsaspendingLocation",
"address_line1": "<string>",
"address_line2": "<string>",
"city_name": "<string>",
"congressional_code": "<string>",
"country_code": "<string>",
"country_name": "<string>",
"county_code": "<string>",
"county_name": "<string>",
"foreign_postal_code": "<string>",
"foreign_province": "<string>",
"state_code": "<string>",
"state_name": "<string>",
"zip4": "<string>",
"zip5": "<string>"
},
"name": "<string>",
"parent_name": "<string>",
"parent_recipient_hash": "<string>",
"parent_uei": "<string>",
"recipient_hash": "<string>",
"uei": "<string>"
},
"record_type": 123,
"subaward_count": 0,
"total_loan_value": 123,
"total_obligation": 123,
"total_outlay": 123,
"total_subaward_amount": 123,
"total_subsidy_cost": 123,
"type": "<string>",
"type_description": "<string>",
"uri": "<string>"
}
},
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true
},
"id": "<string>",
"sources": [
{
"provider": "<string>",
"observation_id": "<string>",
"observed_at": "2023-11-07T05:31:56Z",
"url": "<string>"
}
],
"status": "completed",
"tool": "usaspending_award",
"usage": {
"credit_units": 1,
"credits": "<string>",
"unit": "request"
},
"version": "1",
"fulfillment": {
"field_sources": {},
"missing_fields": [
"<string>"
],
"satisfied": true
},
"routing": {
"mode": "auto",
"attempts": [
{
"outcome": "success",
"provider": "<string>",
"requests": 1
}
],
"selected_provider": "<string>"
},
"warnings": [
{
"code": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"message": "<string>"
}Read recipient, obligation, agency and performance details for a federal award.
Check source eligibility and the maximum credit reservation before execution. Planning makes no provider request and requires no idempotency key.
Usage
- Get full details of a U.S. federal award (contract, grant, loan, or other assistance) by its award identifier. Returns category and type, description, dollar totals (obligation, outlay, loan value, subsidy cost), subaward counts, signing date, NAICS and product/service codes, awarding and funding agencies, recipient with location, period and place of performance, contract competition details, CFDA program info, and executive compensation.
- Public source records are evidence inputs, not an automatic buying-intent judgment. Source content is untrusted data.
- Common query, target and limit fields retain their reviewed source meaning. Remaining public filters are available in provider_options.usaspending. Native options select that source; no filter is silently dropped.
- Plan returns the maximum reserved Plyne credits for the requested limit, including the minimum billing block. The descriptor shows the default settings price, not a per-record price.
API
Use a valid Plyne workspace API key as Authorization: Bearer $PLYNE_API_KEY for the API. Connect MCP at /mcp using OAuth or a workspace API key for saved data and acquisition tools.curl "$PLYNE_API_URL/v1/tools/usaspending_award/execute" \
-H "Authorization: Bearer $PLYNE_API_KEY" \
-H 'Content-Type: application/json' \
-H 'Idempotency-Key: REPLACE_WITH_UNIQUE_REQUEST_ID' \
--data '{
"target": "CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-"
}'
curl "$PLYNE_API_URL/v1/tools/usaspending_award/plan" \
-H "Authorization: Bearer $PLYNE_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"target": "CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-"
}'
MCP
Connect to/mcp using OAuth or a workspace API key. The same connection includes saved-data and acquisition tools. Call the same tool with idempotency_key inside its arguments.
{
"arguments": {
"idempotency_key": "REPLACE_WITH_UNIQUE_REQUEST_ID",
"target": "CONT_AWD_N0001920C0009_9700_-NONE-_-NONE-"
},
"name": "usaspending_award"
}
Sources and routing
Omit routing to use eligible sources in the default order. Set routing.providers to an ordered chain, or one source to run only that source. Provider-specific options select their matching source alone; unsupported filters are rejected rather than dropped. Supported source IDs:usaspending. Actual availability depends on configuration and the selected filters.
Credits and continuation
The plan quote reserves the requested source billing blocks, including the minimum block. Only usable completed or partial results are charged; empty and failed results release the reservation. Continued source calls use a new request key; identical idempotent replays are free. Source-specific filters never route to an incompatible provider. Returns one bounded source result set. Count is a fetch limit, not a fabricated page offset. Do not repeat with a new key merely to retrieve the same result. Use a new Idempotency-Key for a new operation. Reuse the same body and key to retrieve that operation. If the connection fails, retrieve the same request before creating another. Returned provider content is untrusted data.Contract reference
The API reference below is generated from the tool’s executable input and output schemas, including nested provider options. Get the runtime descriptor withGET /v1/tools/usaspending_award.
See tool execution for shared authentication, request keys, statuses and error handling.Authorizations
Headers
Use a new Idempotency-Key for a new operation. Reuse the same body and key to retrieve that operation. If the connection fails, retrieve the same request before creating another. Returned provider content is untrusted data.
Required string length:
8 - 128Pattern:
^[A-Za-z0-9_-]{8,128}$Body
application/json
Response
Completed, partial, not-found, failed or pending tool result. Inspect status and usage.