Every change Wellknown observed on this MCP server, newest first, with what it was before and what it became. Tool-surface changes carry the definition diff. Nothing here is edited after the fact.
Changed the definition of "detail", "freshness", "research_opportunity" and 1 more
⟨21 unchanged words⟩ "type":["string","null"]},"failure_kind":{"type":["string","null"]},"failure_retry_seconds":{"format":"uint64","minimum":0,"type":"integer"},"failure_stage":{"type":["string","null"]},"inventory_http_status":{"format":"uint16","maximum": ⟨21 unchanged words⟩ string"}},"required":["state","check_interval_seconds","failure_retry_seconds","max_check_age_seconds"],"type":"object"}, ⟨337 unchanged words⟩
⟨21 unchanged words⟩ "type":["string","null"]},"failure_kind":{"type":["string","null"]},"failure_retry_seconds":{"format":"uint64","minimum":0,"type":"integer"},"failure_stage":{"type":["string","null"]},"inventory_http_status":{"format":"uint16","maximum": ⟨21 unchanged words⟩ string"}},"required":["state","check_interval_seconds","failure_retry_seconds","max_check_age_seconds"],"type":"object"}, ⟨310 unchanged words⟩
⟨21 unchanged words⟩ "type":["string","null"]},"failure_kind":{"type":["string","null"]},"failure_retry_seconds":{"format":"uint64","minimum":0,"type":"integer"},"failure_stage":{"type":["string","null"]},"inventory_http_status":{"format":"uint16","maximum": ⟨21 unchanged words⟩ string"}},"required":["state","check_interval_seconds","failure_retry_seconds","max_check_age_seconds"],"type":"object"}, ⟨440 unchanged words⟩
⟨21 unchanged words⟩ "type":["string","null"]},"failure_kind":{"type":["string","null"]},"failure_retry_seconds":{"format":"uint64","minimum":0,"type":"integer"},"failure_stage":{"type":["string","null"]},"inventory_http_status":{"format":"uint16","maximum": ⟨21 unchanged words⟩ string"}},"required":["state","check_interval_seconds","failure_retry_seconds","max_check_age_seconds"],"type":"object"}, ⟨411 unchanged words⟩
Changed the definition of "freshness"
⟨94 unchanged words⟩ ,"unavailable"],"type":"string"},"NoticeArchiveCoverage":{"properties":{"dataset":{"type":"string"},"reason":{"type":["string","null"]},"retired_on":{"type":["string","null"]},"state":{"type":"string"}},"required":["dataset","state"],"type":"object"},"NoticeHistoryCoverage":{"properties":{"archives":{"items":{"$ref":"#/$defs/NoticeArchiveCoverage"},"type":"array"},"complete_historical_archive":{"type":"boolean"},"current_dataset":{"type":"string"},"current_source_date":{"type":["string","null"]},"remaining_coverage":{"type":"string"},"scope":{"type":"string"}},"required":["scope","current_dataset","complete_historical_archive","remaining_coverage","archives"],"type":"object"},"SourceCoverage":{"properties":{"award_freshness":{"anyOf ⟨181 unchanged words⟩ ,"history":{"type":"string"},"history_coverage":{"$ref":"#/$defs/NoticeHistoryCoverage","description":"Notice snapshot coverage, retired fiscal-year archives and the dated retention policy."},"sources":{"items":{"$ref":"#/$defs/SourceCoverage" ⟨2 unchanged words⟩ ,"required":["generation","sources","history","history_coverage"],"type":"object"}
Changed the definition of "check_exclusions", "detail", "document" and 1 more
⟨16 unchanged words⟩ "name":{"description":"Person or organizationname;name, within 256 UTF-8 bytes; name-only matches are possible matches.","type": ⟨73 unchanged words⟩
⟨164 unchanged words⟩ "name":{"description":"Person or organizationname;name, within 256 UTF-8 bytes; name-only matches are possible matches.","type": ⟨162 unchanged words⟩
Changed the definition of "document"
⟨38 unchanged words⟩ length":{"description":"Characters to return,upfrom 1 to 16,000. Smaller chunks may be needed to fit the response byte budget.","format":"uint64","maximum":16000,"minimum":01,"type":["integer","null"]}, ⟨22 unchanged words⟩
Added "create_saved_search", "delete_saved_search", "delete_saved_search_workspace" and 3 more; removed "saved_searches" (12 tools before, 17 now)
Create a saved search — Create one private saved opportunity search with the supplied name and criteria. Requires authenticated workspace access and explicit user intent. Creates an account workspace if needed and adds a search without replacing existing searches. Returns a private feed link. The first successful check establishes a baseline; no email or external notification is sent.
Delete a saved search — Permanently delete one saved search owned by the authenticated private workspace, including its baseline, retained change events and feed link. Requires explicit user intent; does not delete other searches or public records.
Delete the saved search workspace — Permanently delete the authenticated private saved-search workspace and all its searches, baselines, change events and feed links. Requires explicit user intent to delete the entire workspace. Does not delete the GovGazette login account, public records or another workspace.
Changed the definition of "check_exclusions", "detail", "document" and 6 more
⟨220 unchanged words⟩ "object"},"SourceFreshness":{"properties":{"attention_required":{"type":"boolean"},"evaluated_at":{"description":"UTC time when age ⟨46 unchanged words⟩ ,"state":{"$ref":"#/$defs/FreshnessState"},"warn_age_seconds":{"description":"Early-warning boundary, separate from the stale-source boundary.","format":"int64","type":"integer"},"warning":{"description":"User-facing warning, or ⟨9 unchanged words⟩ ,"required":["state","evaluated_at","max_age_seconds","warn_age_seconds","attention_required"],"type":"object"}},"$schema" ⟨21 unchanged words⟩
Changed the definition of "detail", "freshness", "research_opportunity" and 1 more
{"$defs":{"AwardAvailability":{"properties":{"artifact_http_status":{"format":"uint16","maximum":65535,"minimum":0,"type":["integer","null"]},"check_interval_seconds":{"format":"uint64","minimum":0,"type":"integer"},"checked_at":{"type":["string","null"]},"inventory_http_status":{"format":"uint16","maximum":65535,"minimum":0,"type":["integer","null"]},"latest_release_date":{"type":["string","null"]},"latest_release_url":{"type":["string","null"]},"max_check_age_seconds":{"format":"int64","type":"integer"},"state":{"type":"string"}},"required":["state","check_interval_seconds","max_check_age_seconds"],"type":"object"},"AwardCoverage":{"properties":{"dataset":{"type":"string"},"freshness":{"$ref":"#/$defs/AwardFreshness"},"source_date":{"type":"string"},"source_url":{"type":"string"}},"required":["dataset","source_date","source_url","freshness"],"type":"object"},"AwardFreshness":{"properties":{"age_state":{"type":"string"},"age_warning_after_days":{"format":"int64","type":"integer"},"effective_source_date":{"type":["string","null"]},"source_age_days":{"format":"int64","type":["integer","null"]},"upstream":{"$ref":"#/$defs/AwardAvailability"},"warning":{"type":["string","null"]}},"required":["age_state","age_warning_after_days","upstream"],"type":"object"},"ExclusionCoverage":{"properties":{"freshness":{"$ref ⟨166 unchanged words⟩ ,"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"award_coverage":{"description":"Award snapshot age and latest official release evidence.","items":{"$ref":"#/$defs/AwardCoverage"},"type":["array","null"]},"collection":{"description":"Absent for curated
Changed the definition of "check_exclusions", "detail", "document" and 5 more
⟨35 unchanged words⟩ identifier matches and name-only possible matches remain distinct. Read coverage.freshness; stale or unknown-source empty lookups report unavailable with snapshot_status no_match_in_snapshot. No match is not clearance.
{"$defs":{"ExclusionCoverage":{"properties":{"freshness":{"$ref":"#/$defs/SourceFreshness","description":"Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."},"observed_at":{"description":"Observation time does not replace the official source timestamp.","type":["string","null"]},"scope":{"type":["string","null"]},"sha256":{"type":["string","null"]},"source_date":{"type":["string","null"]},"source_url":{"type":["string","null"]},"status":{"description":"Present as unavailable when no SAM coverage exists in this generation.","type":["string","null"]}},"required":["freshness"],"type":"object"},"ExclusionMatch":{"properties":{"identity":{"$ref ⟨15 unchanged words⟩ :"#/$defs/JsonObject"},"type":"array"},"snapshot_status":{"description":"Observed lookup outcome in the dated snapshot, even when
Recently observed → Live
Changed the definition of "check_exclusions" and "detail"
Checkup1 to 20 identities against a dated active SAM snapshot. Pass identities as an array of objects, not a record ID or page URL. Each identity needs a name, UEI, CAGE, or NPI. Exact identifier matches and name-only possible matches remain ⟨6 unchanged words⟩
⟨88 unchanged words⟩ ,"items":{"$ref":"#/$defs/Identity"},"maxItems":20,"minItems":1,"type":"array"}},"required":["identities ⟨2 unchanged words⟩
Live → Recently observed
Certificate changed, valid to 2026-12-26
Unavailable → Live
Changed the definition of "exclusion_changes", "saved_searches", "search" and 2 more
⟨37 unchanged words⟩ service page limit.","format":"uint","maximum":50,"minimum":01,"type":["integer","null"]}, ⟨18 unchanged words⟩
⟨85 unchanged words⟩ defaults to 25.","format":"uint","maximum":50,"minimum":01,"type":["integer","null"]}, ⟨135 unchanged words⟩
Recently observed → Unavailable
Live → Recently observed
Authorization not required
Changed the definition of "check_exclusions", "detail", "document" and 9 more
⟨2 unchanged words⟩ additionalProperties":false,"properties":{"cage":{"description":"Exact five-character CAGE code, when known.","type":["string","null"]},"name":{"description":"Person or organization name; name-only matches are possible matches.","type":["string","null"]},"npi":{"description":"Exact ten-digit National Provider Identifier, when known.","type":["string","null"]},"uei":{"description":"Exact 12-character Unique Entity ID, when known.","type":["string","null"]}}," ⟨5 unchanged words⟩ additionalProperties":false,"properties":{"generation":{"description":"Retained snapshot UUID; omit for the current snapshot.","type":["string","null"]},"identities":{"description":"One to twenty identities to compare with the dated SAM snapshot.","items":{"$ref":"#/$defs/Identity"},"type ⟨5 unchanged words⟩
Changed the definition of "check_exclusions", "detail", "document" and 9 more
before
—after
Check possible exclusion matches{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}
before
—Read a federal record
Added "research_opportunity", "saved_searches" and "search_opportunities" (9 tools before, 12 now)
Build a cited research brief with retained notice requirements, exact award-number candidates and same-industry comparisons. Does not infer an incumbent or eligibility.
Manage private saved opportunity searches: list/create/events/delete/rotate_feed/delete_workspace. Requires Authorization Bearer workspace key configured in the client headers, never tool arguments. Ask before creating or deleting. Public research tools do not require this key.
Find official opportunity records by keywords, industry, set-aside, state, agency and source status. Active does not imply the deadline is open.
Added "check_exclusions", "exclusion_changes", "exclusion_context" and 1 more (5 tools before, 9 now)
Check up to 20 identities against a dated active SAM snapshot. Exact identifier matches and name-only possible matches remain distinct. No match is not clearance.
Compare two retained snapshots. No longer observed does not mean reinstated; enrichment-only changes are excluded.
Retrieve an exclusion with agency explanation, named restriction references, source evidence and supported business links.
Filter active exclusion records by agency, program, classification, geography and dates. Preserve the returned cursor and generation.
Added "detail", "document", "explain_match" and 2 more; removed "apply_business_profile_update", "assess_opportunity_for_business", "check_business_exclusions" and 38 more (41 tools before, 5 now)
Retrieve a known public identifier. Supply generation from search for a consistent result.
Read bounded official record text by known identifier. Does not fetch arbitrary URLs or paths.
Explain deterministic primary NAICS overlap between a registered vendor and opportunity. Not an eligibility determination.
Report actual source dates, coverage, record counts and SHA256 provenance.
Search public opportunities, vendors, awards, exclusions, or reference collections. Results include provenance and a generation-pinned cursor.
Authorization not required, issuer https://supabase.govgazette.com/auth/v1
Authorization not required, issuer https://supabase.govgazette.com/auth/v1
Authorization not required, issuer https://supabase.govgazette.com/auth/v1
Authorization not required, issuer https://supabase.govgazette.com/auth/v1
Authorization not required, issuer https://supabase.govgazette.com/auth/v1
Added "export_opportunities" and "review_opportunity" (39 tools before, 41 now)
Export open opportunities — Free bounded JSON export of up to 50 soonest open opportunities. Not the full dataset.
Review an opportunity — Free fixed-rule bid/no-bid research review with cited reasons. Does not save private work or establish eligibility.
Certificate recorded, valid to 2026-10-28
Authorization not required, issuer https://supabase.govgazette.com/auth/v1
First tool surface recorded: 39 tools (server version 1.4.0)
Showing the latest 31 events. The API returns up to 500 and filters by kind: ?kind=tool_surface_changed
Retrieve aknownpublicidentifier.recordSupplyusinggenerationthefromexact collection and id returned by search, never a page URL, title or slug. Supply the returned generation for a consistent result.
Readboundedofficial record text using the exact collection, id and generation returned byknownsearch.identifier.Start at offset 0 with length 1 to 16,000 characters, then use next_offset unchanged for the next chunk. Does not fetch arbitrary URLs or paths.
⟨5 unchanged words⟩ agency, program, classification, geography and dates.PreserveLimittheisreturnedacursormaximum; large records can produce a smaller page with page_size_limited true. Continue with next_cursor andgeneration.unchangedReadfilters and limit. Preserve generation and read coverage.freshness for source age and warnings; results are ⟨4 unchanged words⟩
⟨95 unchanged words⟩ :{"description":"Maximum records to return,upfrom 1 tothe50.serviceLargepagerecords may produce a smaller page; continue with next_cursor and unchanged filters and limit.","format":"uint","maximum": ⟨49 unchanged words⟩
⟨276 unchanged words⟩ :{"type":["string","null"]},"page_size_limited":{"description":"Whole records were deferred to next_cursor to fit the response budget. Continue with the same filters and requested limit.","type":"boolean"}},"required":["generation","items","page_size_limited","coverage"],"type":"object"}
Read saved search changes — Read the latest 100 retained change observations for one saved search owned by the authenticated private workspace. Does not change the search. Retention and missing intermediate observations are explicit; observations are not proof of delivered notifications.
List saved searches — List the saved opportunity searches in the authenticated private workspace, including criteria, status and change counts. Does not change searches. Requires workspace Authorization headers on /mcp or account OAuth on /account/mcp; never accept keys in tool arguments.
Replace a saved search feed link — Replace the private feed link for one saved search owned by the authenticated workspace, immediately revoking its previous link. Requires explicit user intent. Does not delete the search or its events. Keep the replacement link private; a lost response may mean the link changed and cannot be recovered by listing searches.
Manage saved searches — Manage private saved opportunity searches: list/create/events/delete/rotate_feed/delete_workspace. Requires Authorization Bearer workspace key configured in the client headers, never tool arguments. Ask before creating or deleting. Public research tools do not require this key.
⟨93 unchanged words⟩ "object"},"SourceFreshness":{"properties":{"attention_required":{"type":"boolean"},"evaluated_at":{"description":"UTC time when age ⟨46 unchanged words⟩ ,"state":{"$ref":"#/$defs/FreshnessState"},"warn_age_seconds":{"description":"Early-warning boundary, separate from the stale-source boundary.","format":"int64","type":"integer"},"warning":{"description":"User-facing warning, or ⟨9 unchanged words⟩ ,"required":["state","evaluated_at","max_age_seconds","warn_age_seconds","attention_required"],"type":"object"}},"$schema" ⟨71 unchanged words⟩
⟨93 unchanged words⟩ "string"},"SourceFreshness":{"properties":{"attention_required":{"type":"boolean"},"evaluated_at":{"description":"UTC time when age ⟨46 unchanged words⟩ ,"state":{"$ref":"#/$defs/FreshnessState"},"warn_age_seconds":{"description":"Early-warning boundary, separate from the stale-source boundary.","format":"int64","type":"integer"},"warning":{"description":"User-facing warning, or ⟨9 unchanged words⟩ ,"required":["state","evaluated_at","max_age_seconds","warn_age_seconds","attention_required"],"type":"object"}},"$schema" ⟨37 unchanged words⟩
⟨93 unchanged words⟩ "object"},"SourceFreshness":{"properties":{"attention_required":{"type":"boolean"},"evaluated_at":{"description":"UTC time when age ⟨46 unchanged words⟩ ,"state":{"$ref":"#/$defs/FreshnessState"},"warn_age_seconds":{"description":"Early-warning boundary, separate from the stale-source boundary.","format":"int64","type":"integer"},"warning":{"description":"User-facing warning, or ⟨9 unchanged words⟩ ,"required":["state","evaluated_at","max_age_seconds","warn_age_seconds","attention_required"],"type":"object"}},"$schema" ⟨64 unchanged words⟩
⟨86 unchanged words⟩ ,"upstream"],"type":"object"},"FreshnessState":{"enum":["fresh","stale","unknown","unavailable"],"type":"string"},"SourceCoverage":{"properties":{"award_freshness":{"anyOf ⟨18 unchanged words⟩ ,"dataset":{"type":"string"},"exclusion_freshness":{"anyOf":[{"$ref":"#/$defs/SourceFreshness"},{"type":"null"}]},"input_rows":{"format":"int64","type": ⟨3 unchanged words⟩ ":"int64","type":"integer"},"reference_edition":{"type":["string","null"]},"reference_scope":{"type":["string","null"]},"sha256":{"type":"string"},"source_date":{"type":"string"},"source_date_kind":{"description":"Meaning of the supplied date; not an importer or scheduler timestamp.","type":"string"},"source_url":{"type":"string"}},"required ⟨2 unchanged words⟩ ","source_date","sha256","input_rows","public_rows","source_date_kind"],"type":"object"},"SourceFreshness":{"properties":{"attention_required":{"type":"boolean"},"evaluated_at":{"description":"UTC time when age was evaluated; source and observation dates are unchanged.","type":"string"},"max_age_seconds":{"description":"Explicit warning threshold for this daily snapshot. Not a scheduler promise.","format":"int64","type":"integer"},"source_age_seconds":{"description":"Age of the official source timestamp, never the import or enrichment timestamp.","format":"int64","type":["integer","null"]},"state":{"$ref":"#/$defs/FreshnessState"},"warn_age_seconds":{"description":"Early-warning boundary, separate from the stale-source boundary.","format":"int64","type":"integer"},"warning":{"description":"User-facing warning, or null when within the warning threshold.","type":["string","null"]}},"required":["state","evaluated_at","max_age_seconds","warn_age_seconds","attention_required"],"type":"object"}},"$schema" ⟨21 unchanged words⟩
⟨356 unchanged words⟩ "object"},"SourceFreshness":{"properties":{"attention_required":{"type":"boolean"},"evaluated_at":{"description":"UTC time when age ⟨46 unchanged words⟩ ,"state":{"$ref":"#/$defs/FreshnessState"},"warn_age_seconds":{"description":"Early-warning boundary, separate from the stale-source boundary.","format":"int64","type":"integer"},"warning":{"description":"User-facing warning, or ⟨9 unchanged words⟩ ,"required":["state","evaluated_at","max_age_seconds","warn_age_seconds","attention_required"],"type":"object"}},"$schema" ⟨43 unchanged words⟩
⟨264 unchanged words⟩ "object"},"SourceFreshness":{"properties":{"attention_required":{"type":"boolean"},"evaluated_at":{"description":"UTC time when age ⟨46 unchanged words⟩ ,"state":{"$ref":"#/$defs/FreshnessState"},"warn_age_seconds":{"description":"Early-warning boundary, separate from the stale-source boundary.","format":"int64","type":"integer"},"warning":{"description":"User-facing warning, or ⟨9 unchanged words⟩ ,"required":["state","evaluated_at","max_age_seconds","warn_age_seconds","attention_required"],"type":"object"}},"$schema" ⟨106 unchanged words⟩
⟨155 unchanged words⟩ "object"},"SourceFreshness":{"properties":{"attention_required":{"type":"boolean"},"evaluated_at":{"description":"UTC time when age ⟨46 unchanged words⟩ ,"state":{"$ref":"#/$defs/FreshnessState"},"warn_age_seconds":{"description":"Early-warning boundary, separate from the stale-source boundary.","format":"int64","type":"integer"},"warning":{"description":"User-facing warning, or ⟨9 unchanged words⟩ ,"required":["state","evaluated_at","max_age_seconds","warn_age_seconds","attention_required"],"type":"object"}},"$schema" ⟨33 unchanged words⟩
{"$defs":{"AwardAvailability":{"properties":{"artifact_http_status":{"format":"uint16","maximum":65535,"minimum":0,"type":["integer","null"]},"check_interval_seconds":{"format":"uint64","minimum":0,"type":"integer"},"checked_at":{"type":["string","null"]},"inventory_http_status":{"format":"uint16","maximum":65535,"minimum":0,"type":["integer","null"]},"latest_release_date":{"type":["string","null"]},"latest_release_url":{"type":["string","null"]},"max_check_age_seconds":{"format":"int64","type":"integer"},"state":{"type":"string"}},"required":["state","check_interval_seconds","max_check_age_seconds"],"type":"object"},"AwardFreshness":{"properties":{"age_state":{"type":"string"},"age_warning_after_days":{"format":"int64","type":"integer"},"effective_source_date":{"type":["string","null"]},"source_age_days":{"format":"int64","type":["integer","null"]},"upstream":{"$ref":"#/$defs/AwardAvailability"},"warning":{"type":["string","null"]}},"required":["age_state","age_warning_after_days","upstream"],"type":"object"},"SourceCoverage":{"properties":{"award_freshness":{"anyOf":[{"$ref":"#/$defs/AwardFreshness"},{"type":"null"}],"description":"Award age and latest official release evidence, independent of publication or scheduler state."},"dataset":{"type":"string"},"input_rows ⟨49 unchanged words⟩
{"$defs":{"AwardAvailability":{"properties":{"artifact_http_status":{"format":"uint16","maximum":65535,"minimum":0,"type":["integer","null"]},"check_interval_seconds":{"format":"uint64","minimum":0,"type":"integer"},"checked_at":{"type":["string","null"]},"inventory_http_status":{"format":"uint16","maximum":65535,"minimum":0,"type":["integer","null"]},"latest_release_date":{"type":["string","null"]},"latest_release_url":{"type":["string","null"]},"max_check_age_seconds":{"format":"int64","type":"integer"},"state":{"type":"string"}},"required":["state","check_interval_seconds","max_check_age_seconds"],"type":"object"},"AwardCoverage":{"properties":{"dataset":{"type":"string"},"freshness":{"$ref":"#/$defs/AwardFreshness"},"source_date":{"type":"string"},"source_url":{"type":"string"}},"required":["dataset","source_date","source_url","freshness"],"type":"object"},"AwardFreshness":{"properties":{"age_state":{"type":"string"},"age_warning_after_days":{"format":"int64","type":"integer"},"effective_source_date":{"type":["string","null"]},"source_age_days":{"format":"int64","type":["integer","null"]},"upstream":{"$ref":"#/$defs/AwardAvailability"},"warning":{"type":["string","null"]}},"required":["age_state","age_warning_after_days","upstream"],"type":"object"},"AwardSummary":{"properties":{"data":{"$ref ⟨149 unchanged words⟩ :"object"},"RecordDetail":{"properties":{"award_coverage":{"description":"Award snapshot age and latest official release evidence.","items":{"$ref":"#/$defs/AwardCoverage"},"type":["array","null"]},"collection":{"description":"Absent for curated ⟨191 unchanged words⟩
{"$defs":{"AwardAvailability":{"properties":{"artifact_http_status":{"format":"uint16","maximum":65535,"minimum":0,"type":["integer","null"]},"check_interval_seconds":{"format":"uint64","minimum":0,"type":"integer"},"checked_at":{"type":["string","null"]},"inventory_http_status":{"format":"uint16","maximum":65535,"minimum":0,"type":["integer","null"]},"latest_release_date":{"type":["string","null"]},"latest_release_url":{"type":["string","null"]},"max_check_age_seconds":{"format":"int64","type":"integer"},"state":{"type":"string"}},"required":["state","check_interval_seconds","max_check_age_seconds"],"type":"object"},"AwardCoverage":{"properties":{"dataset":{"type":"string"},"freshness":{"$ref":"#/$defs/AwardFreshness"},"source_date":{"type":"string"},"source_url":{"type":"string"}},"required":["dataset","source_date","source_url","freshness"],"type":"object"},"AwardFreshness":{"properties":{"age_state":{"type":"string"},"age_warning_after_days":{"format":"int64","type":"integer"},"effective_source_date":{"type":["string","null"]},"source_age_days":{"format":"int64","type":["integer","null"]},"upstream":{"$ref":"#/$defs/AwardAvailability"},"warning":{"type":["string","null"]}},"required":["age_state","age_warning_after_days","upstream"],"type":"object"},"ExclusionCoverage":{"properties":{"freshness":{"$ref ⟨228 unchanged words⟩ ,"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"award_coverage":{"description":"Dated award coverage and official release availability, when applicable.","items":{"$ref":"#/$defs/AwardCoverage"},"type":["array","null"]},"collection":{"description":"Collection searched, such ⟨81 unchanged words⟩
{"$defs":{"ExclusionCoverage":{"properties":{"freshness":{"$ref":"#/$defs/SourceFreshness","description":"Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."},"observed_at":{"description":"Observation time does not replace the official source timestamp.","type":["string","null"]},"scope":{"type":["string","null"]},"sha256":{"type":["string","null"]},"source_date":{"type":["string","null"]},"source_url":{"type":["string","null"]},"status":{"description":"Present as unavailable when no SAM coverage exists in this generation.","type":["string","null"]}},"required":["freshness"],"type":"object"},"FreshnessState":{"enum":["fresh","stale","unknown","unavailable"],"type":"string"},"JsonObject":{"description":"Source-specific JSON map. The ⟨6 unchanged words⟩ by official source.","type":"object"},"SourceFreshness":{"properties":{"evaluated_at":{"description":"UTC time when age was evaluated; source and observation dates are unchanged.","type":"string"},"max_age_seconds":{"description":"Explicit warning threshold for this daily snapshot. Not a scheduler promise.","format":"int64","type":"integer"},"source_age_seconds":{"description":"Age of the official source timestamp, never the import or enrichment timestamp.","format":"int64","type":["integer","null"]},"state":{"$ref":"#/$defs/FreshnessState"},"warning":{"description":"User-facing warning, or null when within the warning threshold.","type":["string","null"]}},"required":["state","evaluated_at","max_age_seconds"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"collection ⟨5 unchanged words⟩ records.","type":["string","null"]},"coverage":{"anyOf":[{"$ref":"#/$defs/ExclusionCoverage"},{"type":"null"}],"description":"Present for exclusions, including explicit source-age warnings."},"data":{"$ref":"#/$defs/JsonObject"}, ⟨48 unchanged words⟩
{"$defs":{"ExclusionCoverage":{"properties":{"freshness":{"$ref":"#/$defs/SourceFreshness","description":"Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."},"observed_at":{"description":"Observation time does not replace the official source timestamp.","type":["string","null"]},"scope":{"type":["string","null"]},"sha256":{"type":["string","null"]},"source_date":{"type":["string","null"]},"source_url":{"type":["string","null"]},"status":{"description":"Present as unavailable when no SAM coverage exists in this generation.","type":["string","null"]}},"required":["freshness"],"type":"object"},"FreshnessState":{"enum":["fresh","stale","unknown","unavailable"],"type":"string"},"JsonObject":{"description":"Source-specific JSON map. The ⟨6 unchanged words⟩ by official source.","type":"object"},"SourceFreshness":{"properties":{"evaluated_at":{"description":"UTC time when age was evaluated; source and observation dates are unchanged.","type":"string"},"max_age_seconds":{"description":"Explicit warning threshold for this daily snapshot. Not a scheduler promise.","format":"int64","type":"integer"},"source_age_seconds":{"description":"Age of the official source timestamp, never the import or enrichment timestamp.","format":"int64","type":["integer","null"]},"state":{"$ref":"#/$defs/FreshnessState"},"warning":{"description":"User-facing warning, or null when within the warning threshold.","type":["string","null"]}},"required":["state","evaluated_at","max_age_seconds"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"coverage":{"anyOf":[{"$ref":"#/$defs/ExclusionCoverage"},{"type":"null"}],"description":"Present for exclusion text chunks, with the same source-age policy as detail."},"document_kind":{"type":"string"},"generation ⟨45 unchanged words⟩
⟨15 unchanged words⟩ ,"change"],"type":"object"},"JsonObjectExclusionCoverage":{"properties":{"freshness":{"$ref":"#/$defs/SourceFreshness","description":"Source-specificFresh,JSONstale,map.unknownTheorenvelopeunavailable,iswithstable;agemapandkeysthevary24-hourbywarning policy."},"observed_at":{"description":"Observation time does not replace the officialsource.source timestamp.","type":["string","null"]},"scope":{"type":["string","null"]},"sha256":{"type":["string","null"]},"source_date":{"type":["string","null"]},"source_url":{"type":["string","null"]},"status":{"description":"Present as unavailable when no SAM coverage exists in this generation.","type":["string","null"]}},"required":["freshness"],"type":"object"},"FreshnessState":{"enum":["fresh","stale","unknown","unavailable"],"type":"string"},"SourceFreshness":{"properties":{"evaluated_at":{"description":"UTC time when age was evaluated; source and observation dates are unchanged.","type":"string"},"max_age_seconds":{"description":"Explicit warning threshold for this daily snapshot. Not a scheduler promise.","format":"int64","type":"integer"},"source_age_seconds":{"description":"Age of the official source timestamp, never the import or enrichment timestamp.","format":"int64","type":["integer","null"]},"state":{"$ref":"#/$defs/FreshnessState"},"warning":{"description":"User-facing warning, or null when within the warning threshold.","type":["string","null"]}},"required":["state","evaluated_at","max_age_seconds"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"from_coverage":{"$ref":"#/$defs/JsonObject#/$defs/ExclusionCoverage"},"from_generation":{"type":"string"} ⟨12 unchanged words⟩ "null"]},"to_coverage":{"$ref":"#/$defs/JsonObject#/$defs/ExclusionCoverage"},"to_generation":{"type":"string"} ⟨9 unchanged words⟩
Retrieve an exclusion with agency explanation, named restriction references, source evidence, explicit source-age warnings and supported business links.
{"$defs":{"ExclusionCoverage":{"properties":{"freshness":{"$ref":"#/$defs/SourceFreshness","description":"Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."},"observed_at":{"description":"Observation time does not replace the official source timestamp.","type":["string","null"]},"scope":{"type":["string","null"]},"sha256":{"type":["string","null"]},"source_date":{"type":["string","null"]},"source_url":{"type":["string","null"]},"status":{"description":"Present as unavailable when no SAM coverage exists in this generation.","type":["string","null"]}},"required":["freshness"],"type":"object"},"FreshnessState":{"enum":["fresh","stale","unknown","unavailable"],"type":"string"},"JsonObject":{"description":"Source-specific JSON map. The ⟨6 unchanged words⟩ by official source.","type":"object"},"SourceFreshness":{"properties":{"evaluated_at":{"description":"UTC time when age was evaluated; source and observation dates are unchanged.","type":"string"},"max_age_seconds":{"description":"Explicit warning threshold for this daily snapshot. Not a scheduler promise.","format":"int64","type":"integer"},"source_age_seconds":{"description":"Age of the official source timestamp, never the import or enrichment timestamp.","format":"int64","type":["integer","null"]},"state":{"$ref":"#/$defs/FreshnessState"},"warning":{"description":"User-facing warning, or null when within the warning threshold.","type":["string","null"]}},"required":["state","evaluated_at","max_age_seconds"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"business_context ⟨13 unchanged words⟩ :"string"},"coverage":{"$ref":"#/$defs/JsonObject#/$defs/ExclusionCoverage","description":"Dated SAM source coverage."} ⟨38 unchanged words⟩
⟨59 unchanged words⟩ ,"scope"],"type":"object"},"ExclusionCoverage":{"properties":{"freshness":{"$ref":"#/$defs/SourceFreshness","description":"Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."},"observed_at":{"description":"Observation time does not replace the official source timestamp.","type":["string","null"]},"scope":{"type":["string","null"]},"sha256":{"type":["string","null"]},"source_date":{"type":["string","null"]},"source_url":{"type":["string","null"]},"status":{"description":"Present as unavailable when no SAM coverage exists in this generation.","type":["string","null"]}},"required":["freshness"],"type":"object"},"FreshnessState":{"enum":["fresh","stale","unknown","unavailable"],"type":"string"},"JsonObject":{"description":"Source-specific JSON map. The ⟨20 unchanged words⟩ "type":["string","null"]},"coverage":{"anyOf":[{"$ref":"#/$defs/ExclusionCoverage"},{"type":"null"}],"description":"Present for exclusions, including explicit source-age warnings."},"data":{"$ref":"#/$defs/JsonObject"},"generation" ⟨41 unchanged words⟩ ","id","title","text","data"],"type":"object"},"SourceFreshness":{"properties":{"evaluated_at":{"description":"UTC time when age was evaluated; source and observation dates are unchanged.","type":"string"},"max_age_seconds":{"description":"Explicit warning threshold for this daily snapshot. Not a scheduler promise.","format":"int64","type":"integer"},"source_age_seconds":{"description":"Age of the official source timestamp, never the import or enrichment timestamp.","format":"int64","type":["integer","null"]},"state":{"$ref":"#/$defs/FreshnessState"},"warning":{"description":"User-facing warning, or null when within the warning threshold.","type":["string","null"]}},"required":["state","evaluated_at","max_age_seconds"],"type":"object"}},"$schema" ⟨43 unchanged words⟩
{"$defs":{"ExclusionCoverage":{"properties":{"freshness":{"$ref":"#/$defs/SourceFreshness","description":"Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."},"observed_at":{"description":"Observation time does not replace the official source timestamp.","type":["string","null"]},"scope":{"type":["string","null"]},"sha256":{"type":["string","null"]},"source_date":{"type":["string","null"]},"source_url":{"type":["string","null"]},"status":{"description":"Present as unavailable when no SAM coverage exists in this generation.","type":["string","null"]}},"required":["freshness"],"type":"object"},"FreshnessState":{"enum":["fresh","stale","unknown","unavailable"],"type":"string"},"JsonObject":{"description":"Source-specific JSON map. The ⟨69 unchanged words⟩ url","data"],"type":"object"},"SourceFreshness":{"properties":{"evaluated_at":{"description":"UTC time when age was evaluated; source and observation dates are unchanged.","type":"string"},"max_age_seconds":{"description":"Explicit warning threshold for this daily snapshot. Not a scheduler promise.","format":"int64","type":"integer"},"source_age_seconds":{"description":"Age of the official source timestamp, never the import or enrichment timestamp.","format":"int64","type":["integer","null"]},"state":{"$ref":"#/$defs/FreshnessState"},"warning":{"description":"User-facing warning, or null when within the warning threshold.","type":["string","null"]}},"required":["state","evaluated_at","max_age_seconds"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"collection ⟨4 unchanged words⟩ as opportunities or awards.","type":"string"},"coverage":{"anyOf":[{"$ref":"#/$defs/ExclusionCoverage"},{"type":"null"}],"description":"Exclusion-specific source age and freshness warnings, when applicable."},"coverage_url":{"description":"Public source-date ⟨56 unchanged words⟩
⟨9 unchanged words⟩ and dates. Preserve the returned cursor and generation. Read coverage.freshness for source age and warnings; results are dated evidence, not clearance.
{"$defs":{"ExclusionCoverage":{"properties":{"freshness":{"$ref":"#/$defs/SourceFreshness","description":"Fresh, stale, unknown or unavailable, with age and the 24-hour warning policy."},"observed_at":{"description":"Observation time does not replace the official source timestamp.","type":["string","null"]},"scope":{"type":["string","null"]},"sha256":{"type":["string","null"]},"source_date":{"type":["string","null"]},"source_url":{"type":["string","null"]},"status":{"description":"Present as unavailable when no SAM coverage exists in this generation.","type":["string","null"]}},"required":["freshness"],"type":"object"},"FreshnessState":{"enum":["fresh","stale","unknown","unavailable"],"type":"string"},"JsonObject":{"description":"Source-specific JSON map. The ⟨69 unchanged words⟩ url","data"],"type":"object"},"SourceFreshness":{"properties":{"evaluated_at":{"description":"UTC time when age was evaluated; source and observation dates are unchanged.","type":"string"},"max_age_seconds":{"description":"Explicit warning threshold for this daily snapshot. Not a scheduler promise.","format":"int64","type":"integer"},"source_age_seconds":{"description":"Age of the official source timestamp, never the import or enrichment timestamp.","format":"int64","type":["integer","null"]},"state":{"$ref":"#/$defs/FreshnessState"},"warning":{"description":"User-facing warning, or null when within the warning threshold.","type":["string","null"]}},"required":["state","evaluated_at","max_age_seconds"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"coverage":{"$ref":"#/$defs/JsonObject#/$defs/ExclusionCoverage","description":"Dated source coverage, or ⟨22 unchanged words⟩
⟨28 unchanged words⟩ "null"]},"id":{"description":"StableExact stable record ID returned bysearch.search, not a page URL or slug.","type":"string"}},"required": ⟨4 unchanged words⟩
⟨38 unchanged words⟩ 1 to 50.","format":"uint","maximum":50,"minimum":01,"type":["integer","null"]}, ⟨17 unchanged words⟩
⟨103 unchanged words⟩ service page limit.","format":"uint","maximum":50,"minimum":01,"type":["integer","null"]}, ⟨43 unchanged words⟩
⟨76 unchanged words⟩ defaults to 25.","format":"uint","maximum":50,"minimum":01,"type":["integer","null"]}, ⟨65 unchanged words⟩
⟨92 unchanged words⟩ defaults to 25.","format":"uint","maximum":50,"minimum":01,"type":["integer","null"]}, ⟨157 unchanged words⟩
before
—after
{"$defs":{"ExclusionMatch":{"properties":{"identity":{"$ref":"#/$defs/Identity"},"records":{"description":"Candidate exclusion records with match basis; not a clearance decision.","items":{"$ref":"#/$defs/JsonObject"},"type":"array"},"status":{"description":"Distinguishes exact-identifier, possible-name and no-match outcomes.","type":"string"},"truncated":{"type":"boolean"}},"required":["identity","status","records","truncated"],"type":"object"},"Identity":{"additionalProperties":false,"properties":{"cage":{"description":"Exact five-character CAGE code, when known.","type":["string","null"]},"name":{"description":"Person or organization name; name-only matches are possible matches.","type":["string","null"]},"npi":{"description":"Exact ten-digit National Provider Identifier, when known.","type":["string","null"]},"uei":{"description":"Exact 12-character Unique Entity ID, when known.","type":["string","null"]}},"type":"object"},"JsonObject":{"description":"Source-specific JSON map. The envelope is stable; map keys vary by official source.","type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"coverage":{"$ref":"#/$defs/JsonObject"},"generation":{"type":"string"},"results":{"items":{"$ref":"#/$defs/ExclusionMatch"},"type":"array"}},"required":["generation","results","coverage"],"type":"object"}{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"collection":{"description":"Public collection name returned by search.","type":"string"},"generation":{"description":"Retained generation UUID from search for a consistent record snapshot.","type":["string","null"]},"id":{"description":"Stable record ID returned by search.","type":"string"}},"required":[" ⟨4 unchanged words⟩
before
—after
{"$defs":{"JsonObject":{"description":"Source-specific JSON map. The envelope is stable; map keys vary by official source.","type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"collection":{"description":"Absent for curated reference records.","type":["string","null"]},"data":{"$ref":"#/$defs/JsonObject"},"generation":{"type":"string"},"id":{"type":"string"},"text":{"type":"string"},"text_has_more":{"description":"Whether another text chunk is available.","type":["boolean","null"]},"text_length":{"description":"Total text characters; absent from internal brief notices.","format":"uint","minimum":0,"type":["integer","null"]},"title":{"type":"string"}},"required":["generation","id","title","text","data"],"type":"object"}{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"collection":{"description":"Public record collection returned by search.","type":"string"},"generation":{"description":"Retained snapshot UUID; omit for the current snapshot.","type":["string","null"]},"id":{"description":"Stable ID of a known public record.","type":"string"},"length":{"description":"Characters to return, up to 16,000.","format":"uint64","minimum":0,"type":["integer","null"]},"offset":{"description":"Character offset for the next bounded text chunk.","format":"uint64","minimum":0,"type ⟨7 unchanged words⟩
before
—after
{"$defs":{"JsonObject":{"description":"Source-specific JSON map. The envelope is stable; map keys vary by official source.","type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"document_kind":{"type":"string"},"generation":{"type":"string"},"id":{"type":"string"},"next_offset":{"format":"uint","minimum":0,"type":["integer","null"]},"offset":{"format":"uint64","minimum":0,"type":"integer"},"provenance":{"anyOf":[{"$ref":"#/$defs/JsonObject"},{"type":"null"}],"description":"Source metadata attached to the retained record."},"text":{"type":"string"}},"required":["generation","id","text","offset","document_kind"],"type":"object"}⟨3 unchanged words⟩ additionalProperties":false,"properties":{"cursor":{"description":"Opaque next_cursor from an earlier change page.","type":["string","null"]},"from_generation":{"description":"Older retained snapshot UUID to compare.","type":"string"},"limit":{"description":"Maximum changes to return, up to the service page limit.","format":"uint","minimum":0,"type":["integer","null"]},"to_generation":{"description":"Newer retained snapshot UUID; omit for the current snapshot.","type":["string","null"]}}, ⟨4 unchanged words⟩
before
—after
{"$defs":{"ExclusionChange":{"properties":{"change":{"type":"string"},"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title","change"],"type":"object"},"JsonObject":{"description":"Source-specific JSON map. The envelope is stable; map keys vary by official source.","type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"from_coverage":{"$ref":"#/$defs/JsonObject"},"from_generation":{"type":"string"},"items":{"items":{"$ref":"#/$defs/ExclusionChange"},"type":"array"},"meaning":{"type":"string"},"next_cursor":{"type":["string","null"]},"to_coverage":{"$ref":"#/$defs/JsonObject"},"to_generation":{"type":"string"}},"required":["from_generation","to_generation","from_coverage","to_coverage","items","meaning"],"type":"object"}⟨3 unchanged words⟩ additionalProperties":false,"properties":{"generation":{"description":"Retained snapshot UUID; omit for the current snapshot.","type":["string","null"]},"id":{"description":"Stable exclusion record ID returned by search_exclusions or check_exclusions.","type":"string"}},"required":[" ⟨3 unchanged words⟩
before
—after
{"$defs":{"JsonObject":{"description":"Source-specific JSON map. The envelope is stable; map keys vary by official source.","type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"business_context":{"$ref":"#/$defs/JsonObject","description":"Supported vendor and award links, with match basis."},"collection":{"type":"string"},"coverage":{"$ref":"#/$defs/JsonObject","description":"Dated SAM source coverage."},"data":{"$ref":"#/$defs/JsonObject"},"generation":{"type":"string"},"id":{"type":"string"},"text":{"type":"string"},"text_has_more":{"type":"boolean"},"text_length":{"format":"uint","minimum":0,"type":"integer"},"title":{"type":"string"}},"required":["generation","collection","id","title","text","data","text_length","text_has_more","coverage","business_context"],"type":"object"}{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"opportunity_id":{"description":"Stable opportunity ID returned by search.","type":"string"},"vendor_id":{"description":"Stable vendor ID returned by search.","type":"string"}},"required":[" ⟨4 unchanged words⟩
before
—after
{"$defs":{"MatchRule":{"properties":{"matched":{"type":"boolean"},"opportunity_value":{"type":["string","null"]},"rule":{"type":"string"},"vendor_value":{"type":["string","null"]}},"required":["rule","matched"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"generation":{"type":"string"},"interpretation":{"type":"string"},"opportunity_id":{"type":"string"},"rules":{"items":{"$ref":"#/$defs/MatchRule"},"type":"array"},"vendor_id":{"type":"string"}},"required":["generation","vendor_id","opportunity_id","rules","interpretation"],"type":"object"}before
—after
{"$defs":{"SourceCoverage":{"properties":{"dataset":{"type":"string"},"input_rows":{"format":"int64","type":"integer"},"public_rows":{"format":"int64","type":"integer"},"sha256":{"type":"string"},"source_date":{"type":"string"},"source_url":{"type":"string"}},"required":["dataset","source_url","source_date","sha256","input_rows","public_rows"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"generation":{"type":"string"},"history":{"type":"string"},"sources":{"items":{"$ref":"#/$defs/SourceCoverage"},"type":"array"}},"required":["generation","sources","history"],"type":"object"}{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"generation":{"description":"Retained generation UUID from search_opportunities.","type":["string","null"]},"id":{"description":"Stable opportunity ID returned by search_opportunities.","type":"string"}},"required":[" ⟨3 unchanged words⟩
before
—after
{"$defs":{"AwardSummary":{"properties":{"data":{"$ref":"#/$defs/JsonObject"},"id":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"},"vendor_url":{"description":"Vendor path when an exact recipient UEI is available.","type":["string","null"]}},"required":["id","title","data","url"],"type":"object"},"BriefRequirements":{"properties":{"scope":{"type":"string"},"source":{"anyOf":[{"$ref":"#/$defs/JsonObject"},{"type":"null"}],"description":"Notice provenance for the retained text."},"text":{"type":"string"}},"required":["text","scope"],"type":"object"},"JsonObject":{"description":"Source-specific JSON map. The envelope is stable; map keys vary by official source.","type":"object"},"RecordDetail":{"properties":{"collection":{"description":"Absent for curated reference records.","type":["string","null"]},"data":{"$ref":"#/$defs/JsonObject"},"generation":{"type":"string"},"id":{"type":"string"},"text":{"type":"string"},"text_has_more":{"description":"Whether another text chunk is available.","type":["boolean","null"]},"text_length":{"description":"Total text characters; absent from internal brief notices.","format":"uint","minimum":0,"type":["integer","null"]},"title":{"type":"string"}},"required":["generation","id","title","text","data"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"comparison_awards":{"items":{"$ref":"#/$defs/AwardSummary"},"type":"array"},"generation":{"type":"string"},"linked_awards":{"items":{"$ref":"#/$defs/AwardSummary"},"type":"array"},"next_steps":{"items":{"type":"string"},"type":"array"},"notice":{"$ref":"#/$defs/RecordDetail"},"relationship_basis":{"type":"string"},"requirements":{"$ref":"#/$defs/BriefRequirements"}},"required":["generation","notice","linked_awards","comparison_awards","relationship_basis","requirements","next_steps"],"type":"object"}⟨12 unchanged words⟩ additionalProperties":false,"properties":{"active":{"description":"Filter by source active status; this does not mean the response deadline is open.","type":["boolean","null"]},"after":{"description":"Last notice ID from next_after in the preceding page.","type":["string","null"]},"agency":{"description":"Agency code on the source notice.","type":["string","null"]},"generation":{"description":"Retained generation UUID from a prior result for a consistent snapshot.","type":["string","null"]},"limit":{"description":"Maximum notices to return, from 1 to 50; defaults to 25.","format":"uint","minimum":0,"type":["integer","null"]},"naics":{"description":"Two- to six-digit NAICS industry code from a notice or the NAICS reference collection.","type":["string","null"]},"q":{"default":"","description":"Plain-language keywords; empty returns notices matching the other filters.","type":"string"},"set_aside":{"description":"Official set-aside code from a notice or the set-asides reference collection.","type":["string","null"]},"state":{"description":"State or territory code for the place of performance.","type":["string","null"]}}," ⟨11 unchanged words⟩ :"#/$defs/OpportunityQuery"},{"type":"null"}],"description":"Opportunity filters for create; the server chooses the current generation."},"id":{"description":"Saved search UUID for events, delete, or rotate_feed.","type":["string","null"]},"name":{"description":"Human-readable name for a new saved search; at most 100 characters.","type":["string","null"]},"operation":{"$ref":"#/$defs/MonitorOperation","description":"Action to perform: list, create, events, delete, rotate_feed, or delete_workspace."}},"required":["operation"],"type":"object"}
before
—after
{"$defs":{"JsonObject":{"description":"Source-specific JSON map. The envelope is stable; map keys vary by official source.","type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"deleted":{"description":"Present for deletion.","type":["boolean","null"]},"events":{"description":"Present for events.","items":{"$ref":"#/$defs/JsonObject"},"type":["array","null"]},"feed_path":{"description":"Present for create or feed rotation.","type":["string","null"]},"id":{"description":"Present for create.","type":["string","null"]},"message":{"description":"Present for create.","type":["string","null"]},"status":{"description":"Present for create.","type":["string","null"]},"watches":{"description":"Present for list; each watch includes status, criteria and event count.","items":{"$ref":"#/$defs/JsonObject"},"type":["array","null"]}},"type":"object"}{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"collection":{"description":"Public collection name, such as opportunities, vendors, awards, exclusions, or naics.","type":"string"},"cursor":{"description":"Opaque next_cursor from the preceding search page.","type":["string","null"]},"limit":{"description":"Maximum records to return, from 1 to 50.","format":"uint","minimum":0,"type":["integer","null"]},"q":{"default":"","description":"Plain-language search terms; empty lists the selected collection.","type":"string"}},"required": ⟨3 unchanged words⟩
before
—after
{"$defs":{"JsonObject":{"description":"Source-specific JSON map. The envelope is stable; map keys vary by official source.","type":"object"},"RecordSummary":{"properties":{"data":{"$ref":"#/$defs/JsonObject","description":"Source-specific fields, including provenance and official identifiers."},"id":{"description":"Stable identifier for a record in this generation.","type":"string"},"summary":{"description":"Short searchable text, when returned by this operation.","type":["string","null"]},"title":{"description":"Human-readable record title.","type":"string"},"url":{"description":"Public canonical path for the record.","type":"string"}},"required":["id","title","url","data"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"collection":{"description":"Collection searched, such as opportunities or awards.","type":"string"},"coverage_url":{"description":"Public source-date endpoint, when this collection supplies it.","type":["string","null"]},"generation":{"description":"UUID of the snapshot used for every result on this page.","type":"string"},"items":{"description":"Matching public records.","items":{"$ref":"#/$defs/RecordSummary"},"type":"array"},"next_cursor":{"description":"Opaque cursor for the next page, or null at the end.","type":["string","null"]}},"required":["generation","collection","items"],"type":"object"}⟨3 unchanged words⟩ additionalProperties":false,"properties":{"agency":{"description":"Excluding agency name or code.","type":["string","null"]},"classification":{"description":"Official SAM exclusion classification code or label.","type":["string","null"]},"country":{"description":"Country name or code in the exclusion record.","type":["string","null"]},"cursor":{"description":"Opaque next_cursor from a previous search response.","type":["string","null"]},"effective_from":{"description":"Include records effective on or after this ISO date.","type":["string","null"]},"effective_to":{"description":"Include records effective on or before this ISO date.","type":["string","null"]},"generation":{"description":"Retained snapshot UUID; omit for the current snapshot.","type":["string","null"]},"limit":{"description":"Maximum records to return, up to the service page limit.","format":"uint","minimum":0,"type":["integer","null"]},"program":{"description":"Exclusion program name or code.","type":["string","null"]},"q":{"description":"Name, identifier, or other text to find in active exclusion records.","type":["string","null"]},"state":{"description":"US state name or postal code in the exclusion record.","type":["string","null"]}},"type":"object"}
before
—after
{"$defs":{"JsonObject":{"description":"Source-specific JSON map. The envelope is stable; map keys vary by official source.","type":"object"},"RecordSummary":{"properties":{"data":{"$ref":"#/$defs/JsonObject","description":"Source-specific fields, including provenance and official identifiers."},"id":{"description":"Stable identifier for a record in this generation.","type":"string"},"summary":{"description":"Short searchable text, when returned by this operation.","type":["string","null"]},"title":{"description":"Human-readable record title.","type":"string"},"url":{"description":"Public canonical path for the record.","type":"string"}},"required":["id","title","url","data"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"coverage":{"$ref":"#/$defs/JsonObject","description":"Dated source coverage, or an unavailable status."},"generation":{"type":"string"},"items":{"items":{"$ref":"#/$defs/RecordSummary"},"type":"array"},"next_cursor":{"type":["string","null"]}},"required":["generation","items","coverage"],"type":"object"}⟨3 unchanged words⟩ additionalProperties":false,"properties":{"active":{"description":"Filter by source active status; this does not mean the response deadline is open.","type":["boolean","null"]},"after":{"description":"Last notice ID from next_after in the preceding page.","type":["string","null"]},"agency":{"description":"Agency code on the source notice.","type":["string","null"]},"generation":{"description":"Retained generation UUID from a prior result for a consistent snapshot.","type":["string","null"]},"limit":{"description":"Maximum notices to return, from 1 to 50; defaults to 25.","format":"uint","minimum":0,"type":["integer","null"]},"naics":{"description":"Two- to six-digit NAICS industry code from a notice or the NAICS reference collection.","type":["string","null"]},"q":{"default":"","description":"Plain-language keywords; empty returns notices matching the other filters.","type":"string"},"set_aside":{"description":"Official set-aside code from a notice or the set-asides reference collection.","type":["string","null"]},"state":{"description":"State or territory code for the place of performance.","type":["string","null"]}},"type":"object"}
before
—after
{"$defs":{"JsonObject":{"description":"Source-specific JSON map. The envelope is stable; map keys vary by official source.","type":"object"},"OpportunityQuery":{"additionalProperties":false,"properties":{"active":{"description":"Filter by source active status; this does not mean the response deadline is open.","type":["boolean","null"]},"after":{"description":"Last notice ID from next_after in the preceding page.","type":["string","null"]},"agency":{"description":"Agency code on the source notice.","type":["string","null"]},"generation":{"description":"Retained generation UUID from a prior result for a consistent snapshot.","type":["string","null"]},"limit":{"description":"Maximum notices to return, from 1 to 50; defaults to 25.","format":"uint","minimum":0,"type":["integer","null"]},"naics":{"description":"Two- to six-digit NAICS industry code from a notice or the NAICS reference collection.","type":["string","null"]},"q":{"default":"","description":"Plain-language keywords; empty returns notices matching the other filters.","type":"string"},"set_aside":{"description":"Official set-aside code from a notice or the set-asides reference collection.","type":["string","null"]},"state":{"description":"State or territory code for the place of performance.","type":["string","null"]}},"type":"object"},"OpportunitySummary":{"properties":{"content_hash":{"description":"Hash of retained notice content for change detection.","type":"string"},"data":{"$ref":"#/$defs/JsonObject"},"id":{"type":"string"},"summary":{"type":"string"},"title":{"type":"string"},"url":{"type":"string"}},"required":["id","title","summary","content_hash","data","url"],"type":"object"}},"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"filters":{"$ref":"#/$defs/OpportunityQuery","description":"Applied search filters."},"generation":{"type":"string"},"items":{"items":{"$ref":"#/$defs/OpportunitySummary"},"type":"array"},"next_after":{"description":"Last record ID for the next page, or null at the end.","type":["string","null"]},"scope":{"description":"Limits of this retained official-notice search.","type":"string"}},"required":["generation","items","filters","scope"],"type":"object"}{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}
before
—after
Read source text{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}
before
—after
Review exclusion changes{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}
before
—after
Read exclusion evidence{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}
before
—after
Explain a vendor match{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}
before
—after
Check source dates{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}
before
—after
Research an opportunity{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}
before
—after
Manage saved searchesbefore
—after
Search federal records{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}
before
—after
Search exclusions{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}
before
—after
Find federal opportunities{"destructiveHint":false,"idempotentHint":true,"openWorldHint":falsetrue,"readOnlyHint":true}
Apply a business-profile update — Apply the exact business-profile patch returned by a recent preview.
Assess one opportunity for the connected business — Compare source-backed opportunity facts with the connected business profile without claiming eligibility or win odds.
Check exclusions for the connected business — Run an exact UEI exclusion lookup for the connected business. This is not a compliance certification.
Export open opportunities — Free bounded JSON export of up to 50 soonest open opportunities. Not the full dataset.
Find inferred recompete candidates — Find awards whose period-of-performance dates suggest a possible recompete. Results are inferences, not confirmed solicitations.
Find inferred recompetes for the connected business — Find inferred recompete candidates across profile markets. Results are not confirmed solicitations.
Get a selected public award — Get one award from the selected hot award dataset.
Get opportunity award evidence — Separate an official notice awardee, linked prior award recipients, and market participants without claiming an incumbent.
Get selected awards for the connected business — Get selected-hot award history for the confirmed profile UEI with explicit coverage limits.
Get business research defaults — Get deterministic opportunity, award, recompete, market, and exclusion defaults from the connected business profile.
Get market evidence for the connected business — Get selected public market summaries for profile classifications, agencies, and target states.
Get the connected business profile — Read the confirmed business identity, capability preferences, public SAM evidence, and selected-award coverage. Requires profile-read permission.
Get a federal market summary — Summarize selected public award and opportunity signals for a market slice.
Get an opportunity — Get one SAM.gov opportunity by notice ID with GovGazette and official source links.
Get an opportunity decision brief — Get a bounded, source-backed response decision brief with deadline status, fit signals, requirements, submission facts, changes, market evidence, and documents.
Get opportunity change history — Get sanitized immutable changes with separate source and detection times.
Get comparable public awards — Get historical comparable public awards. Results are not an independent cost estimate or win odds.
Get public opportunity documents — List current public SAM attachments with official external download links and links to published untrusted plain-text chunks when available. Raw binaries are not proxied.
Get deterministic opportunity facts — Get exact citations, requirements, costs, dates, forms, and submission text extracted without an LLM.
Get a vendor — Get a public vendor or awardee record by 12-character UEI.
Get vendor awards — Get public award history for one vendor UEI.
Get monitoring status — Read connected-account searches, pursuits, award or vendor watches, and recompete radars. Requires OAuth and never changes a watch.
Look up an official acquisition reference — Search or retrieve NAICS, PSC, FAR, SBA size-standard, set-aside, or agency reference data.
Preview a business-profile update — Preview exact changes to capabilities and target markets before applying them.
Resolve a federal contract identifier — Resolve notice, solicitation, award, PIID, UEI, CAGE, NAICS, PSC, or FAR identifiers with exact matches first.
Review an opportunity — Free fixed-rule bid/no-bid research review with cited reasons. Does not save private work or establish eligibility.
Save an opportunity search — Save a federal opportunity search and choose its alert cadence.
Save a recompete radar — Save a rolling radar for awards entering an inferred recompete window.
Search selected public awards — Search the selected hot award dataset by award, recipient, agency, classification, place, dates, and value.
Search current public exclusions — Check the current public exclusion snapshot by exact UEI or CAGE, or cautious name search. This is not a compliance certification.
Search deterministic opportunity facts — Search exact source-backed facts extracted from official opportunity descriptions.
Search federal contract opportunities — Search public opportunity data by text, classification, buyer, location, status, and dates.
Find opportunities for the connected business — Rank open opportunities against the connected business profile with transparent reasons. This is not a win probability.
Search public vendors — Search current public SAM entities by name, UEI, CAGE, status, location, or primary NAICS.
Track an opportunity — Add or replace one tracked opportunity and its next action in the connected account.
Update an award or vendor watch — Change, pause, or resume an award or vendor watch.
Update a recompete radar — Change, pause, or resume a recompete radar.
Update a saved search — Change or disable a saved search in the connected GovGazette account.
Update a tracked opportunity — Change or disable a tracked opportunity in the connected account.
Watch an award — Watch a selected public award for material changes and activity.
Watch a vendor — Watch public award activity for one exact vendor UEI.