# GovGazette public contracting data

Anonymous, read-only REST: https://govgazette.com/api/v1
MCP Streamable HTTP: https://govgazette.com/mcp
OpenAPI: https://govgazette.com/api/v1/openapi.json
Coverage: https://govgazette.com/api/v1/freshness
Aggregate processing and delivery readiness: https://govgazette.com/api/v1/status
This reports process-level evidence without customer data. Change inbox and Atom
feed readiness is not proof of receipt. External notifications are not implemented.
The API root returns a machine-readable link index and request limits.
There is no per-minute quota or X-RateLimit-* header. Requests have a five-second
deadline and a 64-request in-flight capacity guard; handle 429/503 responses
with bounded backoff and do not assume missing headers mean unlimited capacity.

Tools: search, detail, freshness, document, explain_match, search_exclusions,
check_exclusions, exclusion_context, exclusion_changes, search_opportunities,
research_opportunity. Private saved_searches requires a workspace bearer key.
Collections: opportunities, vendors, awards, exclusions, naics, psc, far,
size-standards, agencies, set-asides, states, counties.
Default page size 25; accepted range 1..50. Preserve generation and cursor across pages.
Award obligations cover imported transactions; never sum cumulative award totals.
Entity records marked no public display are excluded. Verify eligibility and
exclusion determinations with the official agency.

Integration catalog and downloads: https://govgazette.com/agents
Portable plugin: https://govgazette.com/integrations/govgazette-plugin.zip
Claude Code plugin: https://govgazette.com/integrations/govgazette-claude-plugin.zip
Public API schema: https://govgazette.com/api/v1/openapi.json
Private monitoring schema: https://govgazette.com/integrations/monitor-openapi.json
Provider recipes, native tests and public listings are tracked separately.
Use a client's secret header configuration for workspace keys, never a prompt.
Public research does not require a key. Create a workspace at /monitor.

GET /api/v1/opportunities/search?q=software&naics=541512&active=true
GET /api/v1/opportunities/research?id=NOTICE_ID
Search also accepts exact set_aside, state and agency filters. Preserve generation
and next_after as after when paging. Active source status does not mean the response
deadline is open. Award-number matches are explicit links; industry comparisons
never establish an incumbent. Requirements cover retained notice text, not all attachments.

POST /api/v1/monitor with Authorization: Bearer WORKSPACE_KEY supports operations
list, create, events, rotate_feed, delete and delete_workspace. Ask for explicit
intent before writes. First complete check establishes a baseline without alerts.
Up to 20 watches per workspace, 500 matches and 100 observations per watch.
Failed/capped checks preserve the baseline. Feed links grant revocable read access.

Exclusion tools share the same dated data as the website.
GET /api/v1/exclusions/search?classification=Firm&program=Reciprocal
GET /api/v1/exclusions/context?id=SAM_UUID
POST /api/v1/exclusions/check {"identities":[{"uei":"ABCDEFGHIJKL"}]}
GET /api/v1/exclusions/changes?from_generation=UUID&to_generation=UUID
Check batches accept 1..20 identities (UEI, CAGE, NPI, or name). Names alone
are possible matches. Conflicting identifiers remain possible matches.
No match in a snapshot is not clearance. Removed records are no longer observed,
not automatically reinstated. External source dates and match evidence are retained.
Change comparisons cover retained generations, not a complete historical archive.