GovSentry Developer API

Free REST endpoints for US government-contracting reference data — state & local procurement portals (with the underlying platform vendor), per-state contract activity, and NAICS codes. No API key, CORS-open, JSON. Licensed CC BY 4.0 — free to use, including commercially, with attribution to GovSentry (govsentry.ai).

Rate limits

Reference endpoints (portals, stats, NAICS): 10 requests / minute per IP.
AI NAICS suggestion (POST): 3 requests / minute per IP (it runs a model).

Base URL: https://govsentry.ai

Endpoints

GET/api/public/state-portals

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" }
    ]
  }
}

GET/api/public/state-stats

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
  }
}

GET/api/public/naics

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" }
  ]
}

POST/api/public/naics-suggest

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": "..." }
  ]
}

Bulk downloads

Need everything at once? The complete datasets — every NAICS code, every state portal (with platform vendor), and per-state stats — are published as open CSV + JSON under CC BY 4.0 on GitHub. The no-parameter /state-portals and /state-stats endpoints also return the full set in one call.

Want live opportunities, not just reference data?

GovSentry matches and scores live SAM.gov and state & local opportunities for your business.

Create Free Account