Veridion Disclosure API
Congressional STOCK Act transactions and executive-branch financial disclosures normalized into one contract. Receipt access is labelled open or gated. The…
Government & public#government
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Congressional STOCK Act transactions and executive-branch financial disclosures normalized into one contract. Receipt access is labelled open or gated. The free tier requires no key and allows 25 rows per request and 60 requests per fixed UTC hour per IP across the disclosure-row endpoints. List, detail, history, Executive, Insiders and Lobbying share one counter, named by X-RateLimit-Policy. An earlier edge rejection names its independent instance-local ceiling instead. Rotating the server credential resets the anonymous budget namespace; ordinary deployments do not. Their per-request Remaining and absolute Reset headers are private, no-store; a counter outage refuses work without publishing a guessed balance. Unrecognized query parameter names are rejected with a typed 400 rather than being silently ignored.
Evaluator requests require usage evidence. A failed terminal usage write never replaces an existing 4xx status or problem code; that metering failure is logged internally under the request identifier. Successful responses are withheld if terminal usage cannot be confirmed, with 503 api_usage_meter_unavailable and Retry-After: 30. This is a backoff instruction, not a recovery-time estimate. Developer and anonymous requests do not use this evaluator event ledger.
Point-in-time history grows from a fixed retained-history floor, not a rolling retention window; GET /api/v1/status publishes temporal_window.point_in_time_floor and unrounded depth_days at measured_at, and no payload history before that floor is reconstructed.
| Plan | Free | Developer | Pilot (key issued by hand, limits planned) | Desk licence (Licence terms) | Firm-wide licence (Licence terms) |
|---|---|---|---|---|---|
| Price | $0, no key | $99.99 a month or $999 a year | $5,000 for 90 days, credited in full if you sign before it ends | From $20,000 a year | From $50,000 a year |
| Who it’s for | Anyone: research, checking, newsrooms, AI assistants | Individuals and companies under $1M in annual revenue building their own app | Investment firms evaluating a licence | One investment team, up to 10 named users | Every team at one firm |
| History | Filings from the last 30 days | Filings from the last 12 months. Executive-branch (OGE) filings: the last 90 days. | Everything in Developer, plus full history for a watchlist of up to 25 names you choose | The full archive | The full archive |
| Rows per request | 25 | 100 | 250 | 1,000 | 1,000 |
| Rows per day | 1,000 | 5,000 | 10,000 | 100,000 | 500,000 |
| Request rate | 60 an hour | 60 a minute | 60 a minute | 120 a minute | 300 a minute |
| Bulk files | No | No | No | Yes | Yes |
| Permitted use | With attribution | Inside your own app. Individual rows shown with attribution. | Internal evaluation only | Internal research | Internal research |
| Support | None | Email, reply within one business day, plus a walkthrough | Email, reply within one business day, named contact | The same, plus onboarding |
Annual delivery starts once the conditions on our licence page are met.
Stability policy
Versioning
The version is major.minor.patch, served on every response as X-API-Version and in this document's info.version. Minor and patch versions are additive: a field, parameter, enum value, endpoint or header may be added; nothing served is removed, renamed or retyped, and every response schema declares additionalProperties: false so an addition is visible in the document the day it ships. Every version has a changelog entry below, dated to the day it reached production.
Breaking changes
A change that removes, renames or retypes anything served is a new major version under a new path prefix (/api/v2). /api/v1 is served, unchanged, for at least twelve months after the new major version is announced, and the announcement is a changelog entry on both versions.
Deprecation
Deprecations are announced in the changelog and marked on the affected element in the contract. Header-only deprecations are published in x-deprecated-headers and response notices, not resource-level headers. Only a deprecated resource sends Deprecation and Sunset (RFC 9745, RFC 8594), together with Link; rel="deprecation" pointing to its notice. No operation is deprecated today; a test refuses an operation marked deprecated without all three headers declared and refuses Deprecation or Sunset on an active operation. Existing X-RateLimit compatibility headers remain available; their removal was deferred in 1.9.0 and no removal date is scheduled.
Methodology
methodology_version on every row names the parsing and admission rules that produced it (currently receipt-or-drop-v1). A change to a derivation rule ships as a new methodology_version and a changelog entry. content_hash covers the government-filing facts, the receipt coordinates and the row's…
Endpoints 14
Disclosures
- GETList receipt-linked disclosure records.
/api/v1/disclosuresAnyone may read filings from the last 30 days without a key: up to 25 rows a request, 60 requests an hour and 1,000 rows a day. Attribution is required… - GETGet observed versions within the caller’s filing window, oldest first.
/api/v1/disclosures/:disclosure_id/historyThe change stream is append-only: a restatement supersedes rather than overwrites, so amendments never erase their predecessors. This returns the observed… - GETGet a disclosure by its permanent identifier.
/api/v1/disclosures/:disclosure_idReturns the latest state for a permanent disclosure_id. A withdrawn row returns 200 with change.state withdrawn, its withdrawal timestamp, and a reason;…
Executive
- GETList receipt-qualified OGE 278-T transactions.
/api/v1/executiveReads accepted first-party temporal serving rows, preserving quarantine and supersession guards. Each transaction carries its stored transaction_id, immutable… - GETGet one receipt-qualified OGE transaction by its stored identifier.
/api/v1/executive/:transaction_idReturns exactly one accepted active version in the current or Developer as_of snapshot, with the same receipt, filed-range, computed_at and content-hash…
Insiders
- GETList SEC Form 4 transaction lines with EDGAR receipts.
/api/v1/insidersReads Veridion's first-party SEC EDGAR Form 4 warehouse for a window of calendar days ending at the latest parsed EDGAR daily index (through_date). Each line…
Lobbying
- GETList Lobbying Disclosure Act filings with LDA.gov receipts.
/api/v1/lobbyingReads Veridion's first-party LDA.gov collection: each filing is the LDA.gov API record Veridion retrieved, served as filed, newest retained revision only,… - GETSummarize Lobbying Disclosure Act filings whose activity text names chip policy, with LDA.gov receipts.
/api/v1/lobbying/chip-policyReads every Lobbying Disclosure Act filing in Veridion's first-party LDA.gov collection whose lobbying activity descriptions, as filed, name chip policy, and…
Stablecoin reserves
- GETList monthly SEC reports of a stablecoin reserve fund, every holding as filed.
/api/v1/stablecoinsReads the monthly SEC reports (Form N-MFP2 and N-MFP3) of the Circle Reserve Fund, the government money market fund that holds most of the USDC reserve, from…
Coverage
- GETGet measured coverage and source provenance.
/api/v1/coverageCounts and rates describing what Veridion has collected, not what it serves. Every rate names its own numerator and denominator fields inside its own object,…
Members
- GETList filers with identity and row coverage.
/api/v1/membersThe filer directory behind every disclosure row. member_id is a Veridion slug and is stable for a single tenure; person_id is the official Bioguide identifier…
Exports
- GETInstitutional bulk delivery access status.
/api/v1/exportBulk archives require a signed institutional licence. Bulk delivery is currently disabled. The read:export scope does not confer institutional entitlement. No…
Status
- GETGet measured source and bulk-snapshot state.
/api/v1/statusThe endpoint to poll before trusting a freshness-sensitive read. status is operational only when every check passes; otherwise it is degraded and…
Service
- GETGet the service index: every operation, the documentation, the limits, the conventions.
/api/v1The first URL a client handed a base path calls. Derived at build time from this document, the problem catalog and the contract limits, so it cannot disagree…
API details
- Base URL
https://www.veridionmarkets.com- Authentication
- A bearer token in the Authorization header
- Operations
- 14 operations on 14 pathsGET 14
- Main resources
- Disclosures 3Executive 2Lobbying 2Coverage 1Exports 1Insiders 1Members 1Service 1Stablecoin reserves 1Status 1
- Response formats
application/problem+jsonapplication/json- Description format
- OpenAPI 3.1.0, API version
1.37.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
How to test the Veridion Disclosure API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Veridion Disclosure API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “List receipt-linked disclosure records.” (GET /api/v1/disclosures), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Veridion Disclosure API?
Congressional STOCK Act transactions and executive-branch financial disclosures normalized into one contract. Receipt access is labelled open or gated. The… It is listed under Government & public and has 14 endpoints.
Who publishes the Veridion Disclosure API?
It is listed from Veridion Markets's public API description (an OpenAPI document), not published by Veridion Markets on Swastik Codes. Anyone who controls veridionmarkets.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Veridion Disclosure API?
Requests go to https://www.veridionmarkets.com. Endpoint paths are added to this base URL.
How do I authenticate with the Veridion Disclosure API?
With A bearer token in the Authorization header.
How many endpoints does the Veridion Disclosure API have?
14 operations on 14 paths (14 GET). The largest groups are Disclosures, Executive, Lobbying, Coverage.
Is forking the Veridion Disclosure API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.