SAM.gov · Schema

SAM.gov Contract Opportunity

A federal contract opportunity published on SAM.gov

Federal GovernmentProcurementContractsEntity ManagementLocation ServicesGSA

Properties

Name	Type	Description
noticeId	string	Unique identifier for the notice
title	string	Title of the contract opportunity
solicitationNumber	string	Solicitation number assigned by the agency
type	string	Type of notice
baseType	string	Base type of the notice
archiveType	string	Archive type
archiveDate	string	Date when opportunity will be archived
naicsCode	string	North American Industry Classification System code
classificationCode	string	Federal Supply Classification (FSC) or Product Service Code (PSC)
department	object	Contracting department/agency details
officeAddress	object	Office address of the contracting office
placeOfPerformance	object	Location where work will be performed
description	string	Full text description of the opportunity
organizationType	string	Type of organization
setAside	object	Small business set-aside details
responseDeadLine	string	Deadline for responses/proposals
active	string	Whether the opportunity is currently active
award	object	Award details if this notice is an award
uiLink	string	URL to view opportunity on SAM.gov
postedDate	string	Date opportunity was posted
modifiedDate	string	Date opportunity was last modified

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.github.io/sam.gov/json-schema/sam-gov-opportunity-schema.json",
  "title": "SAM.gov Contract Opportunity",
  "description": "A federal contract opportunity published on SAM.gov",
  "type": "object",
  "properties": {
    "noticeId": {
      "type": "string",
      "description": "Unique identifier for the notice"
    },
    "title": {
      "type": "string",
      "description": "Title of the contract opportunity"
    },
    "solicitationNumber": {
      "type": "string",
      "description": "Solicitation number assigned by the agency"
    },
    "type": {
      "type": "string",
      "description": "Type of notice",
      "enum": [
        "Presolicitation",
        "Combined Synopsis/Solicitation",
        "Solicitation",
        "Award Notice",
        "Special Notice",
        "Sources Sought",
        "Intent to Bundle Requirements",
        "Justification and Approval"
      ]
    },
    "baseType": {
      "type": "string",
      "description": "Base type of the notice"
    },
    "archiveType": {
      "type": "string",
      "description": "Archive type"
    },
    "archiveDate": {
      "type": "string",
      "format": "date",
      "description": "Date when opportunity will be archived"
    },
    "naicsCode": {
      "type": "string",
      "description": "North American Industry Classification System code"
    },
    "classificationCode": {
      "type": "string",
      "description": "Federal Supply Classification (FSC) or Product Service Code (PSC)"
    },
    "department": {
      "type": "object",
      "description": "Contracting department/agency details",
      "properties": {
        "departmentId": {
          "type": "string"
        },
        "departmentName": {
          "type": "string"
        },
        "subTier": {
          "type": "string"
        },
        "office": {
          "type": "string"
        }
      }
    },
    "officeAddress": {
      "type": "object",
      "description": "Office address of the contracting office",
      "properties": {
        "city": {
          "type": "string"
        },
        "state": {
          "type": "string"
        },
        "zip": {
          "type": "string"
        },
        "countryCode": {
          "type": "string"
        }
      }
    },
    "placeOfPerformance": {
      "type": "object",
      "description": "Location where work will be performed",
      "properties": {
        "city": {
          "type": "object",
          "properties": {
            "code": {"type": "string"},
            "name": {"type": "string"}
          }
        },
        "state": {
          "type": "object",
          "properties": {
            "code": {"type": "string"},
            "name": {"type": "string"}
          }
        },
        "country": {
          "type": "object",
          "properties": {
            "code": {"type": "string"},
            "name": {"type": "string"}
          }
        },
        "zip": {
          "type": "string"
        }
      }
    },
    "description": {
      "type": "string",
      "description": "Full text description of the opportunity"
    },
    "organizationType": {
      "type": "string",
      "description": "Type of organization"
    },
    "setAside": {
      "type": "object",
      "description": "Small business set-aside details",
      "properties": {
        "setAsideCode": {
          "type": "string"
        },
        "setAsideDescription": {
          "type": "string"
        }
      }
    },
    "responseDeadLine": {
      "type": "string",
      "format": "date-time",
      "description": "Deadline for responses/proposals"
    },
    "active": {
      "type": "string",
      "enum": ["Yes", "No"],
      "description": "Whether the opportunity is currently active"
    },
    "award": {
      "type": "object",
      "description": "Award details if this notice is an award",
      "properties": {
        "date": {
          "type": "string",
          "format": "date"
        },
        "number": {
          "type": "string"
        },
        "amount": {
          "type": "string"
        },
        "awardee": {
          "type": "object",
          "properties": {
            "name": {"type": "string"},
            "location": {
              "type": "object"
            },
            "ueiSAM": {"type": "string"}
          }
        }
      }
    },
    "uiLink": {
      "type": "string",
      "format": "uri",
      "description": "URL to view opportunity on SAM.gov"
    },
    "postedDate": {
      "type": "string",
      "format": "date",
      "description": "Date opportunity was posted"
    },
    "modifiedDate": {
      "type": "string",
      "format": "date",
      "description": "Date opportunity was last modified"
    }
  },
  "required": ["noticeId", "title", "type"],
  "additionalProperties": false
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this

find_json_schemasBrowse and filter every JSON Schema in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This JSON Schema

curl "https://apis.io/api/v1/json-schemas/sam-gov-opportunity"

All schemas

curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.