Search contracts, IDVs, vehicles, GSA eLibrary Schedule holders, CALC labor rates, OTAs, OTIDVs, subawards, organizations, GAO bid protests, federal grants, federal budget accounts, DIBBS awards, SAM exclusions (debarments), and SAM entity registrations (vendors). This is the primary data retrieval tool : use it to find records by vendor, organization, NAICS/PSC code, date range, or type-specific filters. Set include_summary=true to get aggregate statistics computed across a hard-capped sample of matching records. For appropriations data use type='budget_account'; for labor rate benchmarking use type='lcat'; for GSA Schedule holder lookups use type='gsa_elibrary'; for vendor debarment checks use type='exclusion'; for DLA parts spending use type='dibbs_award'; for vendor population/attribute queries use type='entity'.
Parameters
Account title contains filter for budget account searches.
Activation date lower bound, YYYY-MM-DD (exclusion type only).
Activation date upper bound, YYYY-MM-DD (exclusion type only).
When true, restrict to exclusions in force today, derived at query time from the activate/termination dates (exclusion type only). A lapsed exclusion is not a change to the record.
Integer CGAC agency code for itdashboard filter (itdashboard type only; Pro+ tier). Use keyword for free-tier text search.
Text match on itdashboard agency name (itdashboard type only; Business+ tier).
Award date range end (YYYY-MM-DD).
Award date range start (YYYY-MM-DD).
Filter subawards by parent contract key (subaward type only).
DIBBS award number, exact (dibbs_award type only). Use '|' for OR.
Award type code to filter by (e.g. 'A' for BPA Call, 'B' for Purchase Order, 'C' for Delivery Order, 'D' for Definitive Contract).
Awardee CAGE code (dibbs_award type only).
Filter by awarding organization : accepts a CGAC code (e.g. '7530' for CMS, '9700' for DOD), name, or abbreviation. Department codes roll up all agencies within that department.
BEA (Bureau of Economic Analysis) category filter for budget account searches (e.g. 'Discretionary', 'Mandatory').
Bureau name filter for budget account searches.
Filter by business size code (lcat type only).
CAGE code filter (exclusion type only).
Assistance Listing (CFDA) number filter for grant searches.
Filter organizations by CGAC (Common Government-wide Accounting Classification) code (organization type only).
Exact CIO risk rating filter: 1=high risk, 5=low risk (itdashboard type only; Business+ tier).
Maximum CIO rating threshold : returns investments at or below this rating (itdashboard type only; Business+ tier).
Exclusion classification type (exclusion type only).
Filter by GSA contract number (gsa_elibrary type only).
Protest decision date range end, YYYY-MM-DD (protest type only).
Protest decision date range start, YYYY-MM-DD (protest type only).
Filter by delisted status (exclusion type only).
DIBBS delivery order number (dibbs_award type only).
Filter protests by GAO docket number (protest type only).
Filter labor rates by education level requirement (lcat type only).
US state filter for entity registrations (entity type only).
Entity UEI for labor rate lookup (lcat type only). Either idv_key or entity_uei is required for lcat searches.
Excluding agency code (exclusion type only).
Excluding agency name (exclusion type only).
Exclusion program filter (exclusion type only).
Exclusion type filter (exclusion type only).
Expiration date range end (YYYY-MM-DD). Filter contracts or IDVs expiring on or before this date.
Expiration date range start (YYYY-MM-DD). Filter contracts or IDVs expiring on or after this date.
Exact federal account symbol (budget_account type). Format: CGAC-MAIN-SUB.
Response shape : comma-separated field names with optional nesting to control which fields are returned per record. Example: 'key,piid,recipient(display_name),obligated'.
Protest filing date range end, YYYY-MM-DD (protest type only).
Protest filing date range start, YYYY-MM-DD (protest type only).
Exact fiscal year match (e.g. 2024).
Fiscal year range end (inclusive).
Fiscal year range start (inclusive).
Funding instrument filter for grant searches (e.g. 'Grant', 'Cooperative Agreement').
Filter by funding organization (code, name, or abbreviation). More reliable than awarding_org for finding contracts that serve a particular mission organization.
Exact grant identifier for grant searches.
Maximum number of award IDVs under the vehicle (vehicle type only).
Minimum number of award IDVs under the vehicle (vehicle type only).
IDV contract key for labor rate lookup (lcat type only). Either idv_key or entity_uei is required for lcat searches.
IDV type filter (idv type only). Examples: 'IDC' (Indefinite Delivery Contract), 'BPA' (Blanket Purchase Agreement), 'BOA' (Basic Ordering Agreement), 'FSS' (Federal Supply Schedule), 'GWAC' (Government-Wide Acquisition Contract).
Include inactive organizations in results (organization type only). Defaults to false.
When true, computes aggregate stats across up to 500 matching records: total obligated, vendor count, set-aside distribution, NAICS distribution, and organization distribution.
Filter itdashboard records by investment type string, e.g. 'Major Investments' (itdashboard type only; Pro+ tier).
Full-text search across descriptions and other text fields.
Filter labor rates by category name (lcat type only).
Last date to order range end (YYYY-MM-DD). Applies to IDV and vehicle searches.
Last date to order range start (YYYY-MM-DD). Applies to IDV and vehicle searches.
Filter organizations by hierarchy level (organization type only). 1=department, 2=agency, 3=bureau, etc.
Maximum number of results to return. Defaults to 25.
Minimum experience floor : filter labor rates requiring at least this many years of experience (lcat type only).
Maximum experience ceiling : filter labor rates requiring at most this many years of experience (lcat type only).
Filter by NAICS (North American Industry Classification System) code.
National Provider Identifier filter (exclusion type only).
National Stock Number, exact (dibbs_award type only). Use '|' for OR.
Obligated amount in USD : greater than or equal to. Filter for contracts with at least this obligation.
Obligated amount in USD : less than or equal to. Filter for contracts with at most this obligation.
On/off-budget flag filter for budget account searches.
Grant opportunity number filter.
Sort direction : 'asc' or 'desc'. Defaults to 'desc' (most recent/largest first).
Maximum number of task orders under the vehicle (vehicle type only).
Minimum number of task orders under the vehicle (vehicle type only).
Filter organizations by type string (organization type only).
Federal-hierarchy key of the buying organization (dibbs_award type only). Always DLA.
Filter protests by outcome (protest type only). Valid values: 'Denied', 'Dismissed', 'Withdrawn', 'Sustained'.
Filter organizations by parent organization key (organization type only).
Manufacturer part number, exact (dibbs_award type only).
When true, return only itdashboard investments with at-risk performance metrics (itdashboard type only; Business+ tier).
Procurement Instrument Identifier : the contract number.
Period of performance end date range : upper bound (YYYY-MM-DD).
Period of performance end date range : lower bound (YYYY-MM-DD).
Period of performance start date range : upper bound (YYYY-MM-DD).
Period of performance start date range : lower bound (YYYY-MM-DD).
Posted date lower bound, YYYY-MM-DD (dibbs_award type only).
Posted date upper bound, YYYY-MM-DD (dibbs_award type only).
Posted date upper bound (YYYY-MM-DD; grant type).
Posted date lower bound (YYYY-MM-DD; grant type).
Minimum hourly rate in USD (lcat type only).
Maximum hourly rate in USD (lcat type only).
Filter subawards by prime contractor UEI (subaward type only).
Filter by vehicle program acronym, e.g. 'OASIS+', 'SEWP', 'STARS' (vehicle type only).
Filter protests by protester company name (protest type only).
Filter by PSC (Product Service Code).
Purchase request number (dibbs_award type only).
Filter by vendor name. Requires near-exact match including suffixes like ', INC.'. If 0 results, the tool automatically retries using the name as a keyword.
Filter by vendor UEI (Unique Entity Identifier). Preferred over recipient_name for precise filtering; use the resolve tool to find the correct UEI.
Filter by GSA Schedule name, e.g. 'MAS' (gsa_elibrary type only).
Filter by security clearance requirement (lcat type only).
Filter by set-aside type code (e.g. 'SBA' for small business, '8AN' for 8(a)). See tango://reference/set-asides for valid codes.
Filter by SIN (Special Item Number) code (gsa_elibrary and lcat types). Not valid for contract-type searches : use type='gsa_elibrary' with sin= to find MAS Schedule holders.
SAM business-type code(s), pipe-OR supported, e.g. 'OY|A2' (entity type only). NOT set-aside codes. Call fetch_api_docs("entities") for the full table.
Solicitation identifier to filter by. Also usable for protest searches to filter by the associated solicitation.
Field to sort results by. For contracts: 'award_date', 'obligated'. For grants: 'posted_date'. For budget accounts: 'obligated_total' or 'enacted_ba'.
Status filter for grant searches (e.g. 'posted', 'forecasted', 'closed').
Filter subawards by subcontractor UEI (subaward type only).
Termination date lower bound, YYYY-MM-DD (exclusion type only).
Termination date upper bound, YYYY-MM-DD (exclusion type only).
Maximum order total in USD (dibbs_award type only).
Minimum order total in USD (dibbs_award type only). The whole ORDER's total, repeated on every line item.
Maximum total dollars obligated under the vehicle (vehicle type only).
Minimum total dollars obligated under the vehicle (vehicle type only).
What record type to search. Options: contract (default), idv, vehicle, all (contracts+IDVs), ota, otidv, subaward, organization, protest, gsa_elibrary, lcat, itdashboard, grant, budget_account.
Last-updated date lower bound, YYYY-MM-DD (exclusion type only).
Last-updated date upper bound, YYYY-MM-DD (exclusion type only).
Only include itdashboard records updated on or after this date, YYYY-MM-DD (itdashboard type only; Pro+ tier).
Only include itdashboard records updated on or before this date, YYYY-MM-DD (itdashboard type only; Pro+ tier).
Filter by vehicle type, e.g. 'GWAC', 'BPA', 'MAS', 'MAC' (vehicle type only).
Filter by eligible user pool, e.g. 'Government-wide', 'Agency-specific' (vehicle type only).
Filter by work location type (lcat type only).