Skip to content

Notices Data Dictionary

This document describes the fields available in the Notices API endpoints (/api/notices/). For filtering, ordering, and pagination, see the Notices API Reference.

Overview

Notices are individual SAM.gov contract opportunity notices. Each notice has a notice_id (UUID). An opportunity can have multiple notices (e.g., amendments); notices are the versioned records. Data is sourced from SAM.gov.

Note: The full set of fields is available via the shape query parameter. See Response Shaping for details.

Update Frequency

Notice data is refreshed from SAM.gov on a regular sync cadence (typically 20–60 minutes).

Fields

Field Type Description Source
notice_id UUID Primary identifier for the notice in Tango. Tango / SAM.gov
active Boolean Whether the notice is active (not archived/cancelled/deleted). Tango (derived)
address Object Notice address. Use expansion for city, state, zip, country. SAM.gov
attachments Array Attachments. Use expansion for attachment_id, file_size, mime_type, name, posted_date, resource_id, type, url, plus the Pro+ sub-fields doc_role, doc_role_alt and extracted_text (each returned only when named explicitly). type is file or link; see Attachments: files and links. SAM.gov
attachment_count Integer Number of attachments of every type, links included. Tango (derived)
award_amount String Award amount, as SAM publishes it (a string, not a number). Award notices only. SAM.gov
award_date Date Award date. Award notices only. SAM.gov
award_number String Award number. SAM.gov
awardee String Awardee name. Award notices only. SAM.gov
awardee_uei String Awardee UEI. Award notices only. SAM.gov
description String Notice description. SAM.gov
file_count Integer Number of attachments with type file: documents attached to the notice. null until counted. API version 5.9.0 or later. Tango (derived)
last_updated DateTime Last modified. SAM.gov
link_count Integer Number of attachments with type link: URLs the notice lists that point somewhere else. null until counted. API version 5.9.0 or later. Tango (derived)
meta Object parent_notice_id, related_notice_id, notice_type, link. Use expansion for subfields; notice_type has code, type. Tango
naics_code String NAICS code. SAM.gov
office Object Contracting office. Use expansion for office/agency/department fields. SAM.gov
opportunity Object Parent opportunity reference. Tango
opportunity_id UUID The Tango opportunity_id of the parent opportunity (when available). Tango
place_of_performance Object Place of performance. Use expansion for street_address, city, state, zip, country. SAM.gov
posted_date DateTime Posted date. SAM.gov
psc_code String Product/Service Code (classification_code). SAM.gov
response_deadline DateTime Response deadline. SAM.gov
sam_url String Canonical SAM.gov notice URL. Tango (derived)
set_aside String Set-aside description. Use expansion set_aside(code,description) for the structured form. SAM.gov
solicitation_number String Solicitation number. SAM.gov
title String Notice title. SAM.gov

Expansions (via shape)

  • attachments, address, archive, place_of_performance, primary_contact (fields: title, full_name, email, phone, fax), secondary_contact, meta (with notice_type(code, type)), office, opportunity, set_aside(code,description)

Notice type codes

Notices classify the notice “type” using a short code. These values come from SAM.gov, with Tango normalizing them to the codes below:

Code Meaning
a Award Notice
g Sale of Surplus Property
i Consolidate/(Substantially) Bundle
j Justification and Approval (J&A)
k Combined Synopsis/Solicitation
l Fair Opportunity / Limited Sources Justification (deprecated)
m Modification/Amendment/Cancel
o Solicitation
p Pre solicitation
r Sources Sought
s Special Notice
u Justification (J&A)

Data Sources

  • SAM.gov – Notice records, offices, contacts, attachments.
  • Tango – notice_id, active, attachment_count, file_count, link_count, meta, sam_url, opportunity.

Usage Notes

Report an issue with this page