API Reference¶

These pages are a curated reference for filtering, ordering, and pagination on Tango's highest-traffic endpoints, with copy/pasteable examples (including SDK usage).

Swagger is still the canonical surface-area reference, but these pages aim to be faster to use day-to-day.

• Swagger (OpenAPI): https://tango.makegov.com/api/
• For field definitions, see the Data Dictionary.

Awards¶

Definitive contracts, indefinite-delivery vehicles, other transactions, subawards, and solicitation-level groupings.

• Contracts — Definitive contract awards. Response shaping →
• IDVs — Indefinite delivery vehicles (GWACs, IDIQs, etc.). Response shaping →
• OTAs — Other Transaction Agreements from FPDS. Response shaping →
• OTIDVs — Other Transaction IDVs from FPDS. Response shaping →
• Subawards — Sub-contracts and sub-grants under prime awards. Response shaping →
• Vehicles — Solicitation-centric grouping of IDVs. Response shaping →
• GSA eLibrary contracts — Persisted GSA eLibrary contract metadata (direct endpoint).

Entities¶

• Entities — Vendors and recipients in federal contracting and assistance; UEI is the canonical identifier (from SAM.gov). Response shaping →

Forecasts¶

• Forecasts — Upcoming procurement opportunities from agency feeds (e.g., HHS, DHS) before they appear as SAM.gov solicitations. Response shaping →

Grants¶

• Grants — Grant opportunities from Grants.gov (funding opportunities, not assistance transactions). Response shaping →

Opportunities¶

SAM.gov contract opportunity and notice data.

• Opportunities — Contract opportunities aggregated by parent. Response shaping →
• Notices — Individual SAM.gov notice records (amendments, updates) under an opportunity. Response shaping →

Metrics¶

• Metrics — Time-series obligation and award-count metrics for entities, NAICS codes, and PSC codes (same URL pattern and query params for all).

Reference data¶

Lookup tables and codes used across awards and entities.

• Assistance listings (CFDA) — CFDA program numbers and titles for federal grants/assistance. Response shaping →
• Business types — SAM.gov business type codes (e.g., small business, 8(a), HUBZone). Response shaping →
• MAS SINs — MAS Special Item Numbers (SINs) reference data. Response shaping →
• NAICS — North American Industry Classification System codes. Response shaping →
• Organizations — Unified federal hierarchy (departments, agencies, offices in one tree with search and obligations). Response shaping →
• PSC — Product/Service Codes for federal contracting. Response shaping →

Shared¶

Objects and legacy endpoints shared across multiple resources. These data structures appear in response shaping expands on many endpoints (e.g., awarding_office(...), department(...), set_aside(...)).

• Shared response objects — Common expanded objects (set-aside, office) returned across endpoints.
• Agencies (deprecated) — Federal agencies (legacy endpoint; use Organizations instead). Response shaping →
• Departments (deprecated) — Top-level federal departments (legacy endpoint; use Organizations instead). Response shaping →
• Offices (deprecated) — Sub-agency offices (legacy endpoint; use Organizations instead). Response shaping →
• Set-aside codes — Set-aside type codes and descriptions.