Data / API / Reference

API reference

The complete contract for the ParseData Agent Gateway: 60 endpoints, six price bands, the signed _meta attestation, and error semantics. Everything here is also machine-readable at /v1/catalog.

New here? Start with the metered API overview, or see pricing.

Price model

Six bands

Every endpoint sits in a band; the band sets the price. You always know the cost before the call — it’s in the catalog entry as price_usd.

Band	Price	What it returns
stats	$0.001 / call	Counts and universe summaries — is the gateway up, how many carriers.
lookup	$0.01 – $0.05 / record	One entity by its federal identifier — a carrier by USDOT, a prevailing wage.
search	$0.05 / row	Filtered list over a universe — carriers, sponsors, opportunities, companies. Billed per row returned.
screen	$0.10 / check	Match an account list against exclusions, enforcement, or OFAC sanctions records.
dossier	$0.10 – $0.25 / entity	The complete file on one subject — carrier360, business360, sponsor dossier.
feed	$0.05 / row	Bulk cursor-paginated stream, up to 1,000 flat rows per page, billed per row returned.

Endpoints

All 60, by dataset

Gateway

Endpoint id	Method & path	Band	Price
gateway.health	GET /v1/health	stats	$0.001

FMCSA — carriers (SaferGrade)

Endpoint id	Method & path	Band	Price
fmcsa.carrier.lookup	GET /v1/carriers/:usdot	lookup	$0.01
fmcsa.carrier.search	GET /v1/carriers/search	search	$0.05/row
fmcsa.carrier.score	GET /v1/carriers/:usdot/score	lookup	$0.05
fmcsa.carrier.vet	GET /v1/carriers/:usdot/vet	lookup	$0.05
fmcsa.carrier360	GET /v1/carriers/:usdot/carrier360	dossier	$0.25
fmcsa.stats.carriers	GET /v1/stats/carriers	stats	$0.001
fmcsa.feed.carriers	GET /v1/feeds/carrier-analytics	feed	$0.05/row

DOL OFLC — sponsors, wages & petitions (PetitionData)

Endpoint id	Method & path	Band	Price
oflc.sponsor.search	GET /v1/sponsors/search	search	$0.05/row
oflc.sponsor.dossier	GET /v1/sponsors/:sponsor	dossier	$0.10
oflc.wages.prevailing	GET /v1/wages/prevailing	lookup	$0.01
oflc.stats.sponsors	GET /v1/stats/sponsors	stats	$0.001
oflc.feed.workforce	GET /v1/feeds/workforce-filings	feed	$0.05/row

SAM.gov / USAspending — contracts (GrantSet)

Endpoint id	Method & path	Band	Price
govcon.opportunity.search	GET /v1/opportunities/search	search	$0.05/row
govcon.opportunity.detail	GET /v1/opportunities/:noticeId	lookup	$0.01
govcon.award.search	GET /v1/awards/search	search	$0.05/row
govcon.stats.opportunities	GET /v1/stats/opportunities	stats	$0.001
govcon.feed.awards	GET /v1/feeds/contract-awards	feed	$0.05/row
govcon.feed.subawards	GET /v1/feeds/subawards	feed	$0.05/row
govcon.subaward.search	GET /v1/subawards/search	search	$0.05/row

FirmStanding — employer risk & entity graph

Endpoint id	Method & path	Band	Price
firmstanding.business360.lookup	GET /v1/business360/lookup	dossier	$0.25
firmstanding.business360	GET /v1/business360/:entityId	dossier	$0.25
firmstanding.screen.exclusions	GET /v1/screens/exclusions	screen	$0.10
firmstanding.screen.enforcement	GET /v1/screens/enforcement	screen	$0.10
firmstanding.company.search	GET /v1/companies/search	search	$0.05/row
firmstanding.stats.companies	GET /v1/stats/companies	stats	$0.001
firmstanding.feed.enforcement	GET /v1/feeds/enforcement-events	feed	$0.05/row
firmstanding.feed.distress	GET /v1/feeds/distress-signals	feed	$0.05/row

partd

Endpoint id	Method & path	Band	Price
partd.feed.prescribing	GET /v1/feeds/pharma-prescribing	feed	$0.05/row
partd.prescriber.search	GET /v1/prescribers/lookup	search	$0.05/row

SEC EDGAR — distress & insider signals

Endpoint id	Method & path	Band	Price
sec.feed.insiders	GET /v1/feeds/insider-buying	feed	$0.05/row
sec.insiders.clusters	GET /v1/insiders/clusters	search	$0.05/row
sec.insiders.transactions	GET /v1/insiders/transactions	search	$0.05/row

ClinicalTrials.gov

Endpoint id	Method & path	Band	Price
trials.feed.starts	GET /v1/feeds/clinical-trials	feed	$0.05/row
trials.trials.search	GET /v1/trials/search	search	$0.05/row
trials.sites.search	GET /v1/trials/sites/search	search	$0.05/row

USPTO — patents

Endpoint id	Method & path	Band	Price
uspto.feed.grants	GET /v1/feeds/patent-grants	feed	$0.05/row
uspto.patents.search	GET /v1/patents/search	search	$0.05/row
uspto.assignees.search	GET /v1/patents/assignees/search	search	$0.05/row

sba

Endpoint id	Method & path	Band	Price
sba.feed.loans	GET /v1/feeds/sba-loans	feed	$0.05/row
sba.loans.search	GET /v1/sba/loans/search	search	$0.05/row

FDA — drug approvals, device clearances & recalls

Endpoint id	Method & path	Band	Price
fda.feed.approvals	GET /v1/feeds/fda-drug-approvals	feed	$0.05/row
fda.feed.clearances	GET /v1/feeds/fda-device-clearances	feed	$0.05/row
fda.approvals.drugs	GET /v1/fda/drug-approvals/search	search	$0.05/row
fda.clearances.devices	GET /v1/fda/device-clearances/search	search	$0.05/row
fda.recalls.search	GET /v1/fda/recalls/search	search	$0.05/row

FDA — warning letters

Endpoint id	Method & path	Band	Price
fda.feed.warningletters	GET /v1/feeds/warning-letters	feed	$0.05/row
fda.warningletters.search	GET /v1/fda/warning-letters/search	search	$0.05/row

VA — procurement & VOSB

Endpoint id	Method & path	Band	Price
va.feed.sdvosb	GET /v1/feeds/sdvosb	feed	$0.05/row
va.facilities.search	GET /v1/va/facilities/search	search	$0.05/row
va.vendors.search	GET /v1/va/vendors/search	search	$0.05/row
va.opportunities.search	GET /v1/va/opportunities/search	search	$0.05/row

EPA — RCRA generators & TRI emitters

Endpoint id	Method & path	Band	Price
epa.feed.rcra	GET /v1/feeds/rcra-handlers	feed	$0.05/row
epa.rcra_handlers.search	GET /v1/epa/rcra-handlers/search	search	$0.05/row
epa.tri.search	GET /v1/epa/tri/search	search	$0.05/row

NLRB — labor relations cases

Endpoint id	Method & path	Band	Price
nlrb.feed.petitions	GET /v1/feeds/labor-petitions	feed	$0.05/row
nlrb.cases.search	GET /v1/nlrb/cases/search	search	$0.05/row

USDA FSIS — establishments & recalls

Endpoint id	Method & path	Band	Price
fsis.establishments.search	GET /v1/fsis/establishments/search	search	$0.05/row
fsis.recalls.search	GET /v1/fsis/recalls/search	search	$0.05/row

MSHA — mine operators & violations

Endpoint id	Method & path	Band	Price
msha.mines.search	GET /v1/msha/mines/search	search	$0.05/row
msha.violations.search	GET /v1/msha/violations/search	search	$0.05/row

TTB — alcohol permittees

Endpoint id	Method & path	Band	Price
ttb.permittees.search	GET /v1/ttb/permittees/search	search	$0.05/row

hrsa

Endpoint id	Method & path	Band	Price
hrsa.hpsa.search	GET /v1/hrsa/hpsa/search	search	$0.05/row
hrsa.mua.search	GET /v1/hrsa/mua/search	search	$0.05/row

cms_tec

Endpoint id	Method & path	Band	Price
cms.timely_care.search	GET /v1/cms/timely-care/search	search	$0.05/row
cms.timely_care.delta	GET /v1/cms/timely-care/delta	search	$0.05/row

hcris

Endpoint id	Method & path	Band	Price
hcris.cost_reports.search	GET /v1/hcris/cost-reports/search	search	$0.05/row
hcris.staffing_decline.search	GET /v1/hcris/staffing-decline/search	search	$0.05/row

FCC — ULS wireless licenses

Endpoint id	Method & path	Band	Price
fcc.licenses.search	GET /v1/fcc/licenses/search	search	$0.05/row

FAA — aircraft registry

Endpoint id	Method & path	Band	Price
faa.aircraft.search	GET /v1/faa/aircraft/search	search	$0.05/row
faa.deregistrations.search	GET /v1/faa/deregistrations/search	search	$0.05/row

PHMSA — pipeline operators & incidents

Endpoint id	Method & path	Band	Price
phmsa.operators.search	GET /v1/phmsa/operators/search	search	$0.05/row
phmsa.incidents.search	GET /v1/phmsa/incidents/search	search	$0.05/row

OFAC / BIS — sanctions & export screens

Endpoint id	Method & path	Band	Price
ofac.screen.sanctions	GET /v1/screens/sanctions	screen	$0.10

Provenance

The _meta attestation

Every JSON response carries a _meta block naming the dataset, the official source and its URL, the data vintage, and an HMAC-SHA256 signature (scheme hmac-sha256-v1) over the canonicalized payload + provenance. The signature lets us prove, on dispute, that a given payload was served with a given source and vintage — the row you bought is the row we published. See data sources for the full chain.

_meta on a feed response

"_meta": {
  "dataset": "firmstanding",
  "source": "DOL OSHA inspections & violations, EPA ECHO facility enforcement, and DOL WHD concluded compliance actions",
  "source_url": "https://firmstanding.com/data",
  "vintage": "2026-07-18",
  "generated_at": "2026-07-24T15:04:11.921Z",
  "license_url": "https://api.govparse.io/v1/license/firmstanding",
  "notice": "Public-source federal records matched to employers by normalized name and address; match tiers and confidence are disclosed on every response. Not a consumer report; no FCRA-regulated use.",
  "scheme": "hmac-sha256-v1",
  "signature": "b91c4f…"
}

Semantics

Errors, limits, and money

402 Payment Required — no valid payment on the request. For x402 the PAYMENT-REQUIRED header carries the challenge; for metered keys, add your x-api-key. See agentic x402.
401 Unauthorized — key missing, unknown, or revoked. 429 Too Many Requests — fair-use rate limit; back off and retry. 404 — no record for that identifier (you are not charged for a 404).
Metering is per successful call. A 4xx/5xx is not metered on the key path. Usage — call count, dollar total, recent calls — is visible any time on your account page.
total_matched caps at 1,000 on search bands; total_matched_capped: true means narrow your filters. Feeds are unbounded via the cursor.
Idempotent reads. Every endpoint is a GET except POST /v1/triggers and its lifecycle calls; retry safely.

LIVE

All 60 endpoints are live in production today.