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, mime_type, name, posted_date, resource_id, type, url (and optionally extracted_text when enabled). SAM.gov
attachment_count Integer Number of attachments. Tango (derived)
description String Notice description. SAM.gov
last_updated DateTime Last modified. SAM.gov
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 and Tango’s loader mapping (src/opportunities/lib/maps.py):

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, meta, sam_url, opportunity.

Usage Notes

Report an issue with this page