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.
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.
{
"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/mcp — tools/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.
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.
| Band | Price | What it is |
|---|---|---|
| stats | $0.001 / call | Universe counts and service health. No filters, effectively free — plan a workload before you pull it. |
| lookup | $0.01 – $0.05 / record | One 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 / row | Filtered 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 / check | Screen 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 / entity | Every federal record on one subject, assembled: sponsor dossier ($0.10), carrier360 ($0.25), business360 ($0.25). |
| feed | $0.05 / row | Bulk, cursor-paginated streams over a whole record. Up to 1,000 flat rows per page, billed per row returned. |
# 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.
| Dataset | Endpoint | Price |
|---|---|---|
| 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 |
# 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.25The 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.
# 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.25The 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.
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.
# 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.
# 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"- Signed: every delivery carries
X-Govparse-Signature: sha256=<hex>(HMAC-SHA256 of the raw body with the Parse’s secret), plusX-Govparse-DeliveryandX-Govparse-Trigger. - At-least-once: each run polls with the per-feed watermark; the watermark advances only after your endpoint returns 2xx, so a failed delivery is re-sent next run. Dedupe on the feed’s stable key.
- Scope: ParseData feeds. See the Parse recipes for 30 worked builds by team.
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.