B2B IntelligenceE-commerceJobs and HiringReal EstateFinanceGovernment and Public RecordsHealthcareTravelSocial and ContentDeveloper Ecosystem

Government and Public Records

Government Contract Award

/extract/json

Federal or state government contract, grant, or other award from USASpending.gov or equivalent.

Download the schemagov-public-records/government-contract-award.json

government-contract-award.schema

// names marked ? are optional

award_id:string// Unique award identifier. Commonly found in: USASpending.gov, SAM.gov, award notice.
piid?:string// Procurement Instrument Identifier (PIID) for contracts. Commonly found in: USASpending.gov, FPDS.
award_type:string// Type of award. Commonly found in: USASpending.gov award type field. One of: contract, grant, loan, idv, other.
agency_name:string// Name of the awarding government agency. Commonly found in: USASpending.gov, award notice, SAM.gov.
agency_code?:string// Agency code. Commonly found in: USASpending.gov, FPDS agency codes.
sub_agency_name?:string// Name of the sub-agency or office. Commonly found in: USASpending.gov, award notice.
award_date:string// Date of the award. Commonly found in: USASpending.gov award date, FPDS.
start_date?:string// Period of performance start date. Commonly found in: USASpending.gov, contract document.
end_date?:string// Period of performance end date. Commonly found in: USASpending.gov, contract document.
potential_total_value_usd?:number// Total potential value of the contract in USD. Commonly found in: USASpending.gov, FPDS.
obligated_amount_usd:number// Amount obligated in USD. Commonly found in: USASpending.gov obligated amount field.
vendor_name:string// Name of the vendor or awardee. Commonly found in: USASpending.gov, award notice, SAM.gov.
vendor_domain?:string// Website domain of the vendor. Commonly found in: company website, SAM.gov entity.
vendor_address?:string// Street address of the vendor. Commonly found in: USASpending.gov, SAM.gov entity.
vendor_city?:string// City of the vendor. Commonly found in: USASpending.gov, SAM.gov entity.
vendor_state?:string// State of the vendor. Commonly found in: USASpending.gov, SAM.gov entity.
vendor_country?:string// Country of the vendor. Commonly found in: USASpending.gov, SAM.gov entity.
vendor_size?:string// Business size of the vendor. Commonly found in: USASpending.gov, FPDS business size. One of: small, large, other.
naics_code?:string// NAICS code for the award. Commonly found in: USASpending.gov, FPDS.
naics_description?:string// NAICS code description. Commonly found in: NAICS code lookup, USASpending.gov.
psc_code?:string// Product and Service Code (PSC). Commonly found in: USASpending.gov, FPDS.
award_description?:string// Description of the award. Commonly found in: award notice, USASpending.gov description field.
set_aside_type?:string// Set-aside type for socioeconomic programs. Commonly found in: USASpending.gov, FPDS set-aside type. One of: small_business, 8a, hubzone, sdvosb, wosb, none, other.
competitive_procedures?:string// Competitive procedures used. Commonly found in: USASpending.gov, FPDS competition type. One of: full_and_open, limited, sole_source, other.
page_title?:string// Title of the source page. Tabstack auto-fills this from page metadata when left empty.
favicon?:string// Favicon URL of the source page. Tabstack auto-fills this from page metadata when left empty.

Try it live

A sample Government Contract Award document, generated from the schema. Edit it, or paste a real response, and see it checked against the schema instantly. It runs in your browser, nothing is sent anywhere.

your-output.json
validation

Valid, matches Government Contract Award

Every required field is present and each value matches its type. Extra fields are allowed. A field the page does not carry is not guaranteed to come back as null, so check values rather than only checking for null.

/extract/json

Copy-paste usage

The same call in TypeScript, Python, and curl. Point it at your own URL and go. The schema drives the response, so you get back the fields you asked for instead of a page to parse.

Features

  • ✓Typed TypeScript and Python SDKs
  • ✓One call, no parsing code and no second LLM pass
  • ✓The same field names on every request, even when the page layout changes
government-contract-award.ts
// curl -sfLO https://raw.githubusercontent.com/Mozilla-Ocho/tabstack-schemas/main/gov-public-records/government-contract-award.json
import Tabstack from '@tabstack/sdk'
import schema from './government-contract-award.json' with { type: 'json' }

const client = new Tabstack() // reads TABSTACK_API_KEY from the environment

try {
  const data = await client.extract.json({
    url: 'https://records.example.gov/filing/12345',
    json_schema: schema,
    effort: 'standard', // 'min' | 'standard' | 'max'
  })

  console.log(data)
} catch (err) {
  console.error('Extraction failed:', err)
}

Related

DocsThis schema on GitHubDocsThe full schema libraryRecipeGuide: extract JSON from any URL

Ship this schema in one call.

Pass a URL, get matching JSON back. Free to start, no extraction layer to maintain.

Get your API key →Read the docs