GovSentry Developer API

State & local eProcurement portals for all 50 states + DC, including the underlying platform vendor (Jaggaer, Bonfire, BidNet, Ionwave, …).

• ?state=VA — Optional. 2-letter code to return a single state.

Example

curl https://govsentry.ai/api/public/state-portals?state=VA

Response

{
  "license": "CC BY 4.0",
  "attribution": "GovSentry (govsentry.ai)",
  "state": {
    "name": "Virginia",
    "code": "VA",
    "officeUrl": "https://...",
    "portals": [
      { "name": "eVA", "url": "https://...",
        "searchDomain": "eva.virginia.gov",
        "platform": "jaggaer", "type": "primary" }
    ]
  }
}

Per-state federal contract activity: historical award counts, historical award dollars, and currently active opportunities.

• ?state=VA — Optional. 2-letter code to return a single state.

Example

curl https://govsentry.ai/api/public/state-stats?state=VA

Response

{
  "license": "CC BY 4.0",
  "generatedAt": "2026-06-03",
  "state": {
    "stateCode": "VA",
    "stateName": "Virginia",
    "historicalAwards": 1234,
    "historicalDollars": 456789000000,
    "activeOpportunities": 321
  }
}

Search NAICS (2022) codes by code prefix or title substring. Returns up to 100 matches.

• ?q=software — Optional. Code prefix (e.g. 5415) or title text (e.g. software).

Example

curl https://govsentry.ai/api/public/naics?q=software

Response

{
  "license": "CC BY 4.0",
  "query": "software",
  "total": 4,
  "returned": 4,
  "results": [
    { "code": "511210", "title": "Software Publishers" },
    { "code": "541511", "title": "Custom Computer Programming Services" }
  ]
}

Live competition analysis: the contractors competing in a NAICS niche and how much each has won, aggregated from 40,000+ federal awards. Optionally narrow to the state(s) where work is performed.

• ?naics=236220 — Required. One or more comma-separated NAICS codes.
• &state=CA,TX — Optional. Comma-separated 2-letter states (place of performance).
• &agency=Department of Defense — Optional. Repeatable. Narrow to a buyer agency (use a name from the returned "agencies" list; matched format-insensitively).
• &size=small — Optional. Filter competitors by business size: small or large.
• &setaside=8a — Optional. Set-aside lane: sb, 8a, wosb, sdvosb, hubzone, or any. The "setAsides" response field lists the lanes present in the niche.
• &limit=50 — Optional. Max competitors returned (1–100, default 50).

Example

curl 'https://govsentry.ai/api/public/competition?naics=236220&state=CA'

Response

{
  "license": "CC BY 4.0",
  "summary": {
    "total_competitors": 97,
    "total_market_value": 12304658648,
    "total_awards": 193,
    "median_award": 28070000,
    "typical_low": 2980000,
    "typical_high": 77520000
  },
  "competitors": [
    { "name": "HARPER CONSTRUCTION COMPANY, INC.",
      "size": "large", "totalValue": 1344500000,
      "avgValue": 74694444, "awardCount": 18,
      "agencyCount": 1 }
  ],
  "agencies": [
    { "name": "Department of Defense",
      "totalValue": 8398386446, "awardCount": 99 }
  ]
}

AI-powered NAICS suggestions from a plain-English business description. Returns 3–5 codes with reasoning.

Example

curl -X POST https://govsentry.ai/api/public/naics-suggest \
  -H "Content-Type: application/json" \
  -d '{"description":"We do commercial HVAC installation and repair"}'

Response

{
  "suggestions": [
    { "code": "238220",
      "title": "Plumbing, Heating, and Air-Conditioning Contractors",
      "reasoning": "..." }
  ]
}