Skip to content

Opportunities Data Dictionary

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

Overview

Opportunities represent SAM.gov contract opportunity notices aggregated by parent opportunity (one opportunity can have multiple notices over time). Each opportunity has an opportunity_id. 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

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

Fields

Field Type Description Source
opportunity_id UUID Primary identifier for the opportunity in Tango (parent notice). Tango / SAM.gov
latest_notice_id UUID The Tango notice_id of the latest notice associated with this opportunity (when available). Tango
active Boolean Whether the opportunity is active. Tango (derived)
archive_date DateTime Archive date for the opportunity (derived from SAM.gov notice archive metadata when present). Tango / SAM.gov
agency_id String Agency code associated with the opportunity (when available). Tango / SAM.gov
award_number String Award number when awarded. SAM.gov
department_id String Department code associated with the opportunity (when available). Tango / SAM.gov
description String Opportunity description (from latest notice). SAM.gov
first_notice_date DateTime First notice date. SAM.gov
last_notice_date DateTime Last notice date. SAM.gov
meta Object Metadata: notices_count, attachments_count, notice_type. Use expansion for subfields. Tango
naics_code String NAICS code. SAM.gov
office Object Contracting office. Use expansion for office_code, office_name, agency_code, agency_name, department_code, department_name. SAM.gov
office_id String Office code associated with the opportunity (when available). Tango / SAM.gov
place_of_performance Object Place of performance. Use expansion for street_address, city, state, zip, country. SAM.gov
primary_contact Object Primary contact (expand for subfields). SAM.gov
secondary_contact Object Secondary contact. SAM.gov
psc_code String Product/Service Code. SAM.gov
response_deadline DateTime Response deadline. SAM.gov
sam_url String Canonical SAM.gov opportunity URL. Tango (derived)
set_aside String Set-aside code. Use expansion set_aside(code,description) for the structured form. SAM.gov
solicitation_number String Solicitation number. SAM.gov
title String Opportunity title (from latest notice). SAM.gov

Expansions (via shape)

  • attachments – attachment_id, mime_type, name, posted_date, resource_id, type, url (and optionally extracted_text when enabled)
  • office – office and agency fields
  • agency – code, name, abbreviation
  • department – code, name, abbreviation, description, cgac, website, congressional_justification
  • latest_notice – notice_id, link
  • place_of_performance – address fields
  • meta – notices_count, attachments_count, notice_type (with nested notice_type(code, type))

Notice type codes

Opportunities and 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 – Contract opportunity notices, offices, contacts, attachments.
  • Tango – opportunity_id, aggregation, sam_url, active.

Usage Notes

Report an issue with this page