gov

Search federal awards (contracts, grants, loans, direct...

Search federal awards (contracts, grants, loans, direct payments) from USAspending.gov. Largest amount first within the date window. Each record includes award ID, recipient name, dollar amount, award type, awarding agency + sub-agency, start + end dates, description, and a permalink to the usaspending.gov detail page. Filter by recipient name, awarding agency name, recipient state, award type group, and date range. Backed by USAspending.gov's spending_by_award API; public-domain US government records.

get/api/gov/usaspending-awards

Request

  • Base URL: https://2s.io
  • URL: https://2s.io/api/gov/usaspending-awards
  • Auth: API key in header PAYMENT-SIGNATURE

Query parameters

recipientstring

Recipient (vendor/grantee) name substring. Examples: "Microsoft", "Lockheed Martin", "Stanford University".

agencystring

Awarding top-tier agency name. Examples: "Department of Defense", "National Institutes of Health", "Department of Energy".

recipientStatestring

2-letter US state of the recipient (e.g., "CA", "VA").

awardType'contracts' | 'grants' | 'loans' | 'direct_payments' | 'other'

Award type group. contracts = A/B/C/D; grants = 02/03/04/05; loans = 07/08; direct_payments = 06/10; other = 11. Default contracts.

sincestring

Earliest action date (YYYY-MM-DD). Default = 5 years ago.

untilstring

Latest action date (YYYY-MM-DD). Default = today.

limitinteger

Records per page (1-100). Default 25.

pageinteger

Page number (1-based). Default 1.

trial1

Try before you buy. Set to 1 for one free real call per endpoint per hour — no wallet or payment needed — to verify the endpoint before paying. Equivalent to sending the "X-2s-Trial: 1" request header. Listed only on operations that offer a trial; the others always answer 402.

Response

(unresolved $ref)

Changes

No recorded changes to this operation across all 1 revision of this API.