ParseData

Data / Metered API

Call it directly. Pay per call.

One API key covers all 60 endpoints on the ParseData Agent Gateway. Look a carrier up, search sponsors, screen an account list, drain a feed, or save a Parse the gateway runs for you — every call metered at its catalog price and billed monthly. This is the same machine the SaaS product runs on, exposed raw.

Not a developer, just want the leads? Start on the homepage — build a Parse in plain English and we deliver matches to your inbox, no code.

API vs SaaS

Two ways to buy the same data

Metered API (this page)

LIVE
  • Billed per call — you pay for the pages you pull and the Parse runs you execute, nothing else.
  • No Parse cap, no seat cap. Rate-limited by fair use, not by a plan tier.
  • Best when you have engineers, a warehouse, or an agent, and you want raw rows in your own pipeline.
  • Sign up on the get-a-key page → a limited billing/usage/keys backend, no Parse UI.

SaaS subscription

  • Flat monthly price per tier — a fixed number of live Parses, unmetered.
  • We do the scheduled checks, dedupe, and delivery. Leads land in your inbox, webhook, Zapier, or CRM.
  • Best when you want sales leads, not a data pipeline. No code.
  • Start on the homepage and describe your Parse in plain English.

Same rows, same attestation — the difference is metered-per-call versus flat-per-month, and raw-pipeline versus done-for-you. SaaS keys are a separate, unmetered key class (billing_mode: saas) excluded from the usage meter; the keys on this page are metered.

Authentication

One header, every endpoint

Send your key as an x-api-key request header (or Authorization: Bearer) on any gateway path. Keys are shown once at checkout and can be rotated from your account page. tools/list and the catalog are public; every priced call needs the key.

a first call
curl "https://api.govparse.io/v1/carriers/80321" \
  -H "x-api-key: gpk_live_..."

# response tail — every JSON body carries a signed _meta attestation:
#   "_meta": {
#     "dataset": "fmcsa",
#     "source": "FMCSA Company Census via data.transportation.gov",
#     "source_url": "https://data.transportation.gov",
#     "vintage": "2026-07-16",
#     "generated_at": "2026-07-24T15:04:11.921Z",
#     "license_url": "https://api.govparse.io/v1/license/fmcsa",
#     "scheme": "hmac-sha256-v1",
#     "signature": "b91c…"
#   }

Discovery

The catalog is the contract

Don’t hard-code endpoints — read them. The public catalog at api.govparse.io/v1/catalog returns every endpoint’s id, path, method, band, price_usd, JSON-Schema input_schema, and a worked output_example. It is machine-readable so an agent can plan a call and know its price before spending anything.

GET /v1/catalog — one endpoint, trimmed
{
  "id": "firmstanding.feed.enforcement",
  "path": "/v1/feeds/enforcement-events",
  "method": "GET",
  "band": "feed",
  "price_usd": 0.05,
  "price_unit": "row",
  "price_atomic_usdc": "50000",
  "dataset": "firmstanding",
  "input_schema": { "type": "object", "properties": {
    "since":  { "type": "string", "description": "event_date lower bound (YYYY-MM-DD)" },
    "agency": { "type": "string", "description": "OSHA | EPA | WHD (CSV)" },
    "state":  { "type": "string", "description": "site state code(s), CSV" },
    "cursor": { "type": "string", "description": "opaque keyset cursor from the prior page" },
    "limit":  { "type": "integer", "description": "rows per page (default 1000, cap 1000)" }
  }},
  "license_url": "https://api.govparse.io/v1/license/firmstanding"
}

The same 60 endpoints are also exposed as MCP tools at https://api.govparse.io/mcptools/list is free, tools/call takes the same key. See agentic x402 for the pay-per-call-without-an-account path.

Beyond the raw source endpoints, the MCP surface exposes higher-level Parse tools so an agent can ask for an outcome, not a query: list_industries and build_parse are free discovery/preview, while get_leads (the matching companies + the events that flagged them) and enrich_contact (the decision-maker) are paid.

Connect your agent with your API key

Point any MCP client (Claude Desktop, your own agent) at the endpoint and pass your account key as x-api-key (or a Bearer token). Free tools work with no key; a paid tools/call is billed to that key — get_leads metered per lead returned, enrich_contact per reveal — or covered by your SaaS plan. No wallet, no x402 required.

call a paid Parse tool with your API key (billed to the key)
curl -s https://api.govparse.io/mcp -X POST \
  -H 'content-type: application/json' \
  -H 'x-api-key: gpk_your_account_key' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_leads",
                 "arguments":{"query":"factoring for brand-new trucking carriers","limit":25}}}'

Price bands

Six bands, one real call each

Every endpoint sits in one of six price bands. The band is the price; it rides on each catalog entry as band and price_usd, so an agent knows the cost before it spends. Here is what each band is and a real call you can make in it.

BandPriceWhat it is
stats$0.001 / callUniverse counts and service health. No filters, effectively free — plan a workload before you pull it.
lookup$0.01 – $0.05 / recordOne record by its natural key — a carrier by USDOT, an opportunity by notice id, a prevailing wage by SOC + state. Score/vet cuts are $0.05.
search$0.05 / rowFiltered list queries — carriers, sponsors, opportunities, awards, companies, plus every Phase-2/3 dataset (FDA, clinical trials, SEC Form 4, subawards, VA, FSIS, FCC, TTB, FAA, PHMSA). Billed for the rows you actually receive; total_matched caps at 1,000.
screen$0.10 / checkScreen a name against a federal list — GSA/OIG exclusions, open OSHA/EPA/WHD enforcement, or the OFAC/BIS consolidated sanctions list — in one call.
dossier$0.10 – $0.25 / entityEvery federal record on one subject, assembled: sponsor dossier ($0.10), carrier360 ($0.25), business360 ($0.25).
feed$0.05 / rowBulk, cursor-paginated streams over a whole record. Up to 1,000 flat rows per page, billed per row returned.
one real call per band — every path exists in the live catalog
# stats  ($0.001) — how many carriers are in the census right now?
curl "https://api.govparse.io/v1/stats/carriers" -H "x-api-key: gpk_live_..."

# lookup ($0.01) — one carrier by USDOT number
curl "https://api.govparse.io/v1/carriers/80321" -H "x-api-key: gpk_live_..."

# search ($0.05/row) — active carriers in Texas (25 rows = $1.25)
curl "https://api.govparse.io/v1/carriers/search?state=TX&limit=25" -H "x-api-key: gpk_live_..."

# screen ($0.10/check) — is this name on a federal exclusion list?
curl "https://api.govparse.io/v1/screens/exclusions?name=Purdue+Pharma" -H "x-api-key: gpk_live_..."

# dossier ($0.25/entity) — the full FMCSA carrier dossier for one USDOT
curl "https://api.govparse.io/v1/carriers/80321/carrier360" -H "x-api-key: gpk_live_..."

# feed   ($0.05/row) — a page of enforcement events since a date (500 rows = $25)
curl "https://api.govparse.io/v1/feeds/enforcement-events?since=2026-06-01&limit=500" -H "x-api-key: gpk_live_..."

Full per-band and per-feed pricing, plus enterprise and institutional licenses, on the data pricing page.

New datasets

New source waves across many new schemas

The catalog grew: openFDA, ClinicalTrials.gov, SEC Form 4, USAspending subawards, USDA FSIS, the VA, EPA (RCRA + TRI), MSHA, NLRB, FDA warning letters, and USPTO patents — and the newest wave, FCC wireless licenses, TTB alcohol permittees, FAA aircraft registrations & deregistrations, and PHMSA pipeline operators & incidents, plus an OFAC/BIS sanctions screen. Every list dataset is a search-band endpoint at $0.05 per row returned, each with the same _meta attestation, keyset paging, and machine-readable input_schema in the catalog. Most support an incremental since= (or first_approval_after= / posted_after= / awarded_after=) date filter so you can poll them forward.

DatasetEndpointPrice
FDA drug approvals/v1/fda/drug-approvals/search$0.05 / row
FDA device clearances (510k/PMA)/v1/fda/device-clearances/search$0.05 / row
FDA recalls (drug + device)/v1/fda/recalls/search$0.05 / row
Clinical trials/v1/trials/search$0.05 / row
Clinical-trial sites/v1/trials/sites/search$0.05 / row
SEC Form 4 insider transactions/v1/insiders/transactions$0.05 / row
SEC Form 4 insider clusters/v1/insiders/clusters$0.05 / row
USAspending subawards (File F)/v1/subawards/search$0.05 / row
VA facilities/v1/va/facilities/search$0.05 / row
VA veteran-owned vendors (SDVOSB/VOSB)/v1/va/vendors/search$0.05 / row
VA contract opportunities/v1/va/opportunities/search$0.05 / row
USDA FSIS establishments/v1/fsis/establishments/search$0.05 / row
USDA FSIS recalls/v1/fsis/recalls/search$0.05 / row
EPA RCRAInfo handlers/v1/epa/rcra-handlers/search$0.05 / row
EPA Toxics Release Inventory/v1/epa/tri/search$0.05 / row
MSHA mines/v1/msha/mines/search$0.05 / row
MSHA violations/v1/msha/violations/search$0.05 / row
NLRB cases (ULP + representation)/v1/nlrb/cases/search$0.05 / row
FDA warning letters/v1/fda/warning-letters/search$0.05 / row
USPTO patents (PatentsView, CC BY 4.0)/v1/patents/search$0.05 / row
USPTO patent assignees (companies)/v1/patents/assignees/search$0.05 / row
FCC wireless licenses (ULS)/v1/fcc/licenses/search$0.05 / row
TTB alcohol permittees/v1/ttb/permittees/search$0.05 / row
FAA aircraft registry/v1/faa/aircraft/search$0.05 / row
FAA deregistrations/v1/faa/deregistrations/search$0.05 / row
PHMSA pipeline operators/v1/phmsa/operators/search$0.05 / row
PHMSA pipeline incidents/v1/phmsa/incidents/search$0.05 / row
OFAC/BIS sanctions screen/v1/screens/sanctions$0.10 / check
one real call per new dataset — every path exists in the live catalog
# FDA — companies that just won a drug approval or supplement
curl "https://api.govparse.io/v1/fda/drug-approvals/search?company=Sandoz&application_type=NDA&since=2026-01-01" -H "x-api-key: gpk_live_..."

# FDA — recent device 510(k) clearances by applicant
curl "https://api.govparse.io/v1/fda/device-clearances/search?company=Medtronic&pathway=510k&since=2026-01-01" -H "x-api-key: gpk_live_..."

# ClinicalTrials.gov — Phase 3 studies now recruiting by lead sponsor
curl "https://api.govparse.io/v1/trials/search?sponsor=Regeneron&phase=PHASE3&status=RECRUITING" -H "x-api-key: gpk_live_..."

# SEC Form 4 — where are insiders buying as a cluster?
curl "https://api.govparse.io/v1/insiders/clusters?direction=buy&min_insiders=3&window=90" -H "x-api-key: gpk_live_..."

# USAspending — new subawardees under a prime's federal work
curl "https://api.govparse.io/v1/subawards/search?prime_recipient=lockheed&new_subawardee=true&new_since=2026-04-01" -H "x-api-key: gpk_live_..."

# VA — veteran-owned (SDVOSB) vendors to target or team with
curl "https://api.govparse.io/v1/va/vendors/search?certification=sdvosb&naics=541&state=VA" -H "x-api-key: gpk_live_..."

# USDA FSIS — meat/poultry/egg plants in a market
curl "https://api.govparse.io/v1/fsis/establishments/search?company=Tyson&state=IA" -H "x-api-key: gpk_live_..."

# EPA — large-quantity hazardous-waste handlers in a state
curl "https://api.govparse.io/v1/epa/rcra-handlers/search?state=OH&generator_status=LQG" -H "x-api-key: gpk_live_..."

# MSHA — significant-and-substantial mine violations since a date
curl "https://api.govparse.io/v1/msha/violations/search?state=WV&since=2026-01-01" -H "x-api-key: gpk_live_..."

# USPTO — companies new to patenting in a technology (candidate signal)
curl "https://api.govparse.io/v1/patents/assignees/search?cpc_subclass=G06N&new_assignee=true&first_grant_after=2024-04-01" -H "x-api-key: gpk_live_..."

# FCC — who just pulled a new wireless license (a buildout tell)?
curl "https://api.govparse.io/v1/fcc/licenses/search?service_group=microwave&state=TX&granted_since=2026-07-01" -H "x-api-key: gpk_live_..."

# FAA — aircraft just deregistered (sold/exported/scrapped) — an asset-disposal event
curl "https://api.govparse.io/v1/faa/deregistrations/search?state=FL&since=2026-01-01" -H "x-api-key: gpk_live_..."

# OFAC/BIS — screen a company against the consolidated sanctions list ($0.10/check)
curl "https://api.govparse.io/v1/screens/sanctions?name=VTB+Bank" -H "x-api-key: gpk_live_..."

USPTO patents — attribution & candidate signals

Patent data is from PatentsView under CC BY 4.0 — attribute USPTO PatentsView when you redistribute. Two derived filters are candidates, not confirmations: new_assignee=true flags a company whose first grant in the ingested window (Jan–Jun 2024 utility grants) falls on/after 2024-04-01, and flipped_inventor=true is a name-keyed inventor-affiliation change that may include same-name collisions. Treat both as leads to verify, never as settled fact.

Dossiers

business360 & carrier360

Two dossier endpoints assemble every federal record we hold on one subject into a single response, so you don’t stitch a dozen calls yourself. Both are in the dossier band at $0.25.

business360

$0.25

The entity dossier for one employer — everything the estate holds on a company, assembled across enforcement, carrier, workforce, and distress. Canonical identity plus per-source sections: OFLC visa filings, WHD wage cases, OSHA inspections/violations, EPA ECHO compliance, FMCSA carriers, and LEIE/SAM exclusions — each with match tier, confidence, and per-source vintage disclosed. Keyed by entity UUID from /v1/companies/search, or looked up by name + state.

business360 — by name, or by entity UUID
# by name + state (resolves the entity, then assembles)
curl "https://api.govparse.io/v1/business360/lookup?name=Tyson+Foods&state=AR" \
  -H "x-api-key: gpk_live_..."

# by entity UUID from /v1/companies/search
curl "https://api.govparse.io/v1/business360/47876324-5171-4e4b-8426-3ef41d511436" \
  -H "x-api-key: gpk_live_..."

carrier360

$0.25

The full FMCSA carrier dossier for one USDOT number — everything the fmcsa schema holds on a carrier in a single call: census identity and status, operating-authority history, insurance filings, SMS inspection and crash summaries, the SaferGrade score, and any authority revocations — each attested to its FMCSA source and vintage.

carrier360 — one USDOT, the whole carrier record
curl "https://api.govparse.io/v1/carriers/80321/carrier360" \
  -H "x-api-key: gpk_live_..."

Both are observational: records present with dates, not a score or a characterization of the company. business360 rides the FirmStanding notice — public records, not a consumer report, no FCRA use.

Bulk feeds

Four streams over the whole record

The feed band exposes four bulk, cursor-paginated streams over the normalized federal record — enforcement events (165,421), workforce filings (268,267), carrier analytics (4,469,912), and the distress-signals composite (23,207) — each a GET returning up to 1,000 flat rows plus a keyset cursor, at $0.05 per row returned. Full schemas, samples, and per-column sources are on the feeds page; the pagination mechanics are next.

Pagination

Keyset cursors, never offsets

Feed endpoints return up to 1,000 flat rows plus an opaque page.next_cursor. Pass it back as cursor= until page.has_more is false to drain a window. The cursor is keyset, not offset: it encodes the last row’s sort key, so it never skips or double-counts a row even as new data lands mid-drain, and paging cost is flat no matter how deep you go.

drain a window, then poll forward
# page 1
curl "https://api.govparse.io/v1/feeds/enforcement-events?since=2026-06-01&state=TX&limit=1000" \
  -H "x-api-key: gpk_live_..."
# → { "rows": [ ... 1000 ... ], "page": { "has_more": true, "next_cursor": "b3M6..." } }

# page 2 — pass next_cursor back verbatim
curl "https://api.govparse.io/v1/feeds/enforcement-events?cursor=b3M6...&limit=1000" \
  -H "x-api-key: gpk_live_..."
# repeat until page.has_more === false

# tomorrow: advance since= to your last event_date watermark, drain again.
# dedupe on the feed's stable key (event_key) so a republished row never fires twice.

Parses over the API

Create Parses by the call

You don’t have to run the checks yourself. Save a Parse config with your key and the gateway runs it on your cadence — daily at 12:00 UTC, or Mondays for weekly — and POSTs new rows to your webhook, HMAC-signed. Unlimited saved Parses; each run meters the rows it actually returns at $0.05 a row, so an empty run costs nothing and you only pay for new matches delivered.

POST /v1/triggers
# save (returns id + signing secret, shown once)
curl -X POST "https://api.govparse.io/v1/triggers" \
  -H "x-api-key: $GOVPARSE_API_KEY" -H "content-type: application/json" \
  -d '{"name":"New TX carriers","webhook_url":"https://example.com/hooks/govparse",
       "cadence":"daily","config":{"plain_english":"Every morning: new carriers in TX.",
       "feeds":[{"event_type":"new_company","feed_id":"fmcsa.feed.carriers",
                 "params":{"state":"TX","added_since":"2026-07-23","limit":"500"}}]}}'

curl "https://api.govparse.io/v1/triggers" -H "x-api-key: $GOVPARSE_API_KEY"          # list
curl -X POST "https://api.govparse.io/v1/triggers/<id>/test" -H "x-api-key: $GOVPARSE_API_KEY"
curl -X DELETE "https://api.govparse.io/v1/triggers/<id>" -H "x-api-key: $GOVPARSE_API_KEY"

Looking for easy?

These pages are the raw developer and agent surface — pull data and run Parses per call. If you just want sales leads delivered without writing code, the SaaS product does the plumbing for you.

Go to parsedata.io →