{"openapi":"3.1.0","info":{"title":"Government Contracts & Grants API","description":"Real-time access to US Government contracts, grants, and agency spending data from USASpending.gov","version":"2.1.0"},"paths":{"/":{"get":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}},"head":{"summary":"Root","operationId":"root__get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/ping":{"get":{"summary":"Ping","operationId":"ping_ping_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/contracts":{"get":{"summary":"Get Contracts","description":"Fetch real US government contracts from USASpending.gov.\nReturns the largest contracts by default, sorted by award amount descending.\nFilter by agency, dollar amount, or keyword.","operationId":"get_contracts_contracts_get","parameters":[{"name":"agency","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by awarding agency name (e.g. 'NASA', 'Department of Defense')","title":"Agency"},"description":"Filter by awarding agency name (e.g. 'NASA', 'Department of Defense')"},{"name":"amount_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum award amount in USD","title":"Amount Min"},"description":"Minimum award amount in USD"},{"name":"amount_max","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Maximum award amount in USD","title":"Amount Max"},"description":"Maximum award amount in USD"},{"name":"keyword","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Keyword search in contract description","title":"Keyword"},"description":"Keyword search in contract description"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of results (max 100)","default":10,"title":"Limit"},"description":"Number of results (max 100)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/grants":{"get":{"summary":"Get Grants","description":"Fetch real US government grants from USASpending.gov.\nReturns the largest grants by default, sorted by award amount descending.","operationId":"get_grants_grants_get","parameters":[{"name":"agency","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Filter by awarding agency name","title":"Agency"},"description":"Filter by awarding agency name"},{"name":"amount_min","in":"query","required":false,"schema":{"anyOf":[{"type":"number"},{"type":"null"}],"description":"Minimum grant amount in USD","title":"Amount Min"},"description":"Minimum grant amount in USD"},{"name":"keyword","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Keyword search in grant description","title":"Keyword"},"description":"Keyword search in grant description"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of results (max 100)","default":10,"title":"Limit"},"description":"Number of results (max 100)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/agencies":{"get":{"summary":"Get Agencies","description":"Fetch list of US government agencies from USASpending.gov.\nReturns agency names, codes, and abbreviations.","operationId":"get_agencies_agencies_get","parameters":[{"name":"limit","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Number of agencies to return","default":50,"title":"Limit"},"description":"Number of agencies to return"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}