# Tango by MakeGov

> Tango is a unified federal procurement and assistance data API. It consolidates
> FPDS, USAspending, SAM.gov, and Grants.gov into one system: contracts, IDVs, OTAs,
> subawards, vehicles, entities, opportunities, forecasts, grants, budget, and protest
> data — with response shaping, webhooks, and an MCP server.

Base URL: https://tango.makegov.com/api/  ·  Auth: `X-API-KEY` request header.

## Start here

- [Quick start](https://docs.makegov.com/getting-started/quick-start/): first authenticated call in cURL, Python, and JavaScript.
- [Authentication](https://docs.makegov.com/getting-started/authentication/): API keys and OAuth2.
- [Plans & pricing](https://docs.makegov.com/getting-started/pricing/): tiers, quotas, and rate limits.
- [OpenAPI spec (JSON)](https://tango.makegov.com/api/openapi.json): full endpoint, parameter, and response definitions in one fetch.
- [Data Dictionary](https://docs.makegov.com/data-dictionary/): field definitions and provenance per resource — what each field means and where it comes from.
- [Cookbook (runnable recipes)](https://github.com/makegov/tango-cookbook): worked Jupyter examples — incumbent radar, protest history, NAICS-to-buyer mapping, budget tracing.
- [All docs (single markdown file)](https://docs.makegov.com/all.md): every page concatenated for LLM ingestion.
- [Python SDK](https://docs.makegov.com/sdks/python/): `pip install tango-python`.
- [Node SDK](https://docs.makegov.com/sdks/node/): `npm install tango`.

## API reference

- Awards: [Contracts](https://docs.makegov.com/api-reference/contracts/), [IDVs](https://docs.makegov.com/api-reference/idvs/), [OTAs](https://docs.makegov.com/api-reference/otas/), [OTIDVs](https://docs.makegov.com/api-reference/otidvs/), [Subawards](https://docs.makegov.com/api-reference/subawards/), [Vehicles](https://docs.makegov.com/api-reference/vehicles/)
- Entities: [Entities](https://docs.makegov.com/api-reference/entities/)
- Opportunities & assistance: [Opportunities](https://docs.makegov.com/api-reference/opportunities/), [Notices](https://docs.makegov.com/api-reference/notices/), [Forecasts](https://docs.makegov.com/api-reference/forecasts/), [Grants](https://docs.makegov.com/api-reference/grants/), [Assistance listings](https://docs.makegov.com/api-reference/assistance-listings/)
- Beta & ancillary: [Budget (Beta)](https://docs.makegov.com/api-reference/budget/), [IT Dashboard](https://docs.makegov.com/api-reference/itdashboard/), [Protests](https://docs.makegov.com/api-reference/protests/)
- Lookups: [NAICS](https://docs.makegov.com/api-reference/naics/), [PSC](https://docs.makegov.com/api-reference/psc/), [Organizations](https://docs.makegov.com/api-reference/organizations/), [Offices](https://docs.makegov.com/api-reference/offices/), [Departments](https://docs.makegov.com/api-reference/departments/), [Set-aside codes](https://docs.makegov.com/api-reference/set-aside/), [Business types](https://docs.makegov.com/api-reference/business-types/), [GSA eLibrary contracts](https://docs.makegov.com/api-reference/gsa-elibrary-contracts/), [LCATs](https://docs.makegov.com/api-reference/lcats/), [MAS SINs](https://docs.makegov.com/api-reference/mas-sins/)
- Utilities: [Resolve](https://docs.makegov.com/api-reference/resolve/), [Validate](https://docs.makegov.com/api-reference/validate/), [Metrics](https://docs.makegov.com/api-reference/metrics/), [Version](https://docs.makegov.com/api-reference/version/)

## Patterns

- [Agency search](https://docs.makegov.com/guides/patterns/agency-search/)
- [Response shaping](https://docs.makegov.com/guides/patterns/response-shaping/)
- [Pagination & result counts](https://docs.makegov.com/guides/patterns/result-counts/)
- [Rate limits & retries](https://docs.makegov.com/guides/patterns/rate-limits/)
- [Vehicles explained](https://docs.makegov.com/guides/patterns/vehicles/)

## How-tos

- [Search opportunities by NAICS](https://docs.makegov.com/guides/how-to/search-opportunities-naics/)
- [Resolve agency names](https://docs.makegov.com/guides/how-to/resolve-agency-names/)
- [Opportunity updates in Slack](https://docs.makegov.com/guides/how-to/opportunity-updates-in-slack/)
- [Get notified of new awards](https://docs.makegov.com/guides/how-to/stream-awards/)
- [Migrate from USAspending](https://docs.makegov.com/guides/how-to/migrate-usaspending/)
- [Explore federal budget data (Beta)](https://docs.makegov.com/guides/how-to/explore-federal-budget/)

## Webhooks

- [Overview](https://docs.makegov.com/webhooks/): subscribe to changes by topic and filter.
- Recipes: [Vendor watchlist](https://docs.makegov.com/webhooks/recipes/vendor-watchlist/), [Awards by NAICS](https://docs.makegov.com/webhooks/recipes/awards-by-naics/), [Track entity changes](https://docs.makegov.com/webhooks/recipes/track-entity-changes/), [Grants by agency](https://docs.makegov.com/webhooks/recipes/grants-by-agency/), [Forecast pipeline](https://docs.makegov.com/webhooks/recipes/forecast-pipeline/)

## Agents

- [MCP (AI agents)](https://docs.makegov.com/mcp/): use Tango from Claude Desktop, Cursor, and other MCP clients.