Evaluation endpoints.
The public API is for catalog discovery and live sample inspection. Commercial evaluation and production access are issued separately after a scope review; the public API does not imply unrestricted bulk access.
| Endpoint | Access | Purpose |
|---|---|---|
GET /health | Public | Service health. |
GET /v1/catalog | Public | Published dataset catalog and metadata. |
GET /v1/datasets/{slug}/latest | Public | Latest published preview for a dataset slug. |
/v1 namespace; unsupported methods return HTTP 405; unknown resources return HTTP 404. Authentication, quotas and bulk-delivery terms for non-public access are confirmed when credentials are issued rather than inferred from the public preview endpoints.Choose the integration path that matches your workflow.
DModify separates public evaluation, application integration, autonomous x402 access and enterprise delivery so developers do not need to learn a payment protocol just to evaluate the data.
Application / business API
Start with the public samples and schemas. Production subscription access is provisioned according to the selected plan and agreed usage limits.
AI agent / autonomous machine
Use the x402 endpoints. The resource returns HTTP 402 with machine-readable payment requirements; an x402-compatible client completes payment and retries the request.
Bulk / historical / enterprise
Use Enterprise access for production integration, bulk or historical delivery, custom delivery, and separately agreed AI/ML or redistribution rights.
Evaluate first. Integrate against explicit contracts.
Public sample API
Product pages use the public preview API to display current accepted samples. These previews are intended for evaluation and do not expose full production artifacts.
curl -i https://api.dmodifydata.com/v1/datasets/sec-financial-filings/latest
x402 testnet flow
Environment: Base Sepolia testnet (eip155:84532). This is explicitly a test environment; it is not represented as mainnet production payment.
# 1. Request a protected resource curl -i "https://x402.dmodifydata.com/x402/v1/sec/financials?cik=0001001907&accession=0001437749-26-031175" # 2. Server returns HTTP 402 + machine-readable payment requirements # 3. An x402-compatible client signs/pays and retries # 4. Successful paid retry returns the validated record
Payment headers should be constructed by an x402-compatible client/SDK rather than copied as static documentation because they are request/payment specific.
Protected endpoint reference
| Resource | Required input |
|---|---|
/x402/v1/sec/financials | cik + accession |
/x402/v1/sec/insiders | record_id |
/x402/v1/us/contracts | generated_award_id |
/x402/v1/sam/opportunities | notice_id |
/x402/v1/eu/ted | publication_number |
/x402/v1/uk/companies/daily | No query parameter; latest validated daily batch |
Error behavior
- 400 — required query parameter missing
- 402 — payment required
- 404 — no matching validated production record
- 503 — validated production source temporarily unavailable
Core field dictionary.
| Field | Type | Nullable / preview availability | Meaning |
|---|---|---|---|
| form_type | string | No | SEC filing that triggered the DModify financial record. |
| filing_date | ISO-8601 date | No | Trigger filing date. |
| accession_number | string | Not in public preview | Trigger SEC accession number in the underlying delivery schema, where supplied. |
| source_filing_url | URI | Not in public preview | Source filing URL in underlying delivery metadata, where supplied; not included in current public sample projection. |
| financial_source_form_type | string | Yes | Periodic filing that supplied financial metrics. |
| financial_source_filing_date | ISO-8601 date | Yes | Date of the periodic source filing. |
| financial_source_accession_number | string | Yes | Accession for the periodic source filing. |
| financial_source_filing_url | URI | Yes | SEC archive URL for the filing supplying metrics. |
| revenue_usd_millions | number | Yes | Normalized revenue where available. |
| net_income_usd_millions | number | Yes | Normalized net income where available. |
| data_quality_status | string | No | PASS or WARN for accepted production records. |
*Live sample records reflect accepted production data; exact requirements are governed by the versioned schema contract.
Core field dictionary.
| Field | Type | Null? | Meaning |
|---|---|---|---|
| cik | string | No | Issuer SEC CIK. |
| trading_symbol | string | Yes | Issuer ticker when available. |
| accession_number | string | Not in public preview | SEC filing accession number in full delivery records where supplied; omitted from current public preview. |
| insider_name | string | No | Reporting owner name from filing. |
| transaction_type | string | Yes | Normalized transaction description. |
| acquired_disposed | string | Yes | Acquired or disposed classification. |
| shares | number | Yes | Reported transaction shares. |
| price_per_share_usd | number | Yes | Reported price per share when present. |
| source_filing_url | URI | Not in public preview | SEC archive URL where supplied in the underlying delivery; absent from current public sample projection. |
| data_quality_status | string | No | Accepted record quality state. |
uk_company_master · schema v1.0.0
Core field dictionary.
UK Company Intelligence · Company Master
| Field | Type | Null? | Meaning |
|---|---|---|---|
| company_number | string | No | Companies House company number; leading zeros preserved. |
| company_name | string | No | Registered company name from the Companies House snapshot. |
| company_status | string | Yes | Official company status. |
| company_type | string | Yes | Registered company type. |
| incorporation_date | ISO-8601 date | Yes | Date of incorporation where supplied. |
| registered_office_address | object/string | Yes | Normalized registered-office address from the source product. |
| sic_codes | array | Yes | Companies House SIC classifications. |
| accounts | object | Yes | Accounts reference and due-date metadata from the company snapshot. |
| confirmation_statement | object | Yes | Confirmation-statement metadata where supplied. |
| source_system | string | No | Companies House. |
| source_product | string | No | Free Company Data Product. |
| record_version_id | string | No | Deterministic DModify record-version identifier. |
| data_quality_status | string | No | DModify QA result. |
| data_quality_messages | array | No | QA warnings/messages; empty when none. |
| change_type | string | No | NEW, UPDATED or UNCHANGED. |
uk_company_accounts · schema v1.2.0
Core field dictionary.
UK Company Intelligence · Accounts
| Field | Type | Null? | Meaning |
|---|---|---|---|
| company_number | string | No | Companies House company number. |
| reporting_period_start | ISO-8601 date | Yes | Selected current reporting-period start. |
| reporting_period_end | ISO-8601 date | Yes | Selected current reporting-period end. |
| currency | string | Yes | Currency of normalized monetary facts; GBP for validated current scope. |
| revenue_gbp | number | Yes | Reported revenue/turnover where disclosed. |
| profit_loss_gbp | number | Yes | Reported profit/loss fact where disclosed. |
| cash_gbp | number | Yes | Reported cash/cash-equivalent fact where disclosed. |
| current_assets_gbp | number | Yes | Reported current assets where disclosed. |
| current_liabilities_gbp | number | Yes | Reported current liabilities where disclosed. |
| total_assets_gbp | number | Yes | Reported total assets only; net-assets concepts are not substituted. |
| total_liabilities_gbp | number | Yes | Reported total liabilities, or conservatively derived when permitted. |
| equity_gbp | number | Yes | Reported equity/shareholder-funds/net-assets concept selected for the period. |
| average_employees | number | Yes | Reported average employee fact; suspicious fractional values are warned. |
| metric_provenance | object | No | Per-metric reported, derived or missing provenance. |
| source_filename | string | No | Companies House accounts source document filename. |
| record_version_id | string | No | Deterministic DModify record-version identifier. |
| data_quality_status | string | No | PASS or WARN for accepted records. |
| data_quality_messages | array | No | QA warnings/messages. |
| change_type | string | No | NEW, UPDATED or UNCHANGED. |
uk_company_psc · schema v1.0.0
Core field dictionary.
UK Company Intelligence · PSC
| Field | Type | Null? | Meaning |
|---|---|---|---|
| company_number | string | No | Companies House company number. |
| psc_kind | string | No | PSC entity/person classification. |
| name | string | No | Public PSC name from Companies House. |
| natures_of_control | array | No | Official Companies House control classifications. |
| nationality | string | Yes | Nationality where supplied for an individual PSC. |
| country_of_residence | string | Yes | Country of residence where supplied. |
| identification | object | Yes | Corporate PSC identification details where applicable. |
| notified_on | ISO-8601 date | Yes | PSC notification date. |
| ceased_on | ISO-8601 date | Yes | Cessation date when the PSC has ceased. |
| record_version_id | string | No | Deterministic DModify record-version identifier. |
| data_quality_status | string | No | DModify QA result. |
| data_quality_messages | array | No | QA warnings/messages. |
| change_type | string | No | NEW, UPDATED or UNCHANGED. |
eu-ted-procurement
Core field dictionary.
EU TED Procurement Notices
| Field | Type | Null? | Meaning |
|---|---|---|---|
| notice identifiers | string | No* | Source notice/publication identifiers retained by the normalized record. |
| buyer | string/object | Yes | Contracting authority/buyer information where published. |
| cpv | string/array | Yes | Common Procurement Vocabulary classification. |
| procedure | string | Yes | Procurement procedure/type where published. |
| publication / deadline dates | date | Yes | Published notice timing and response/deadline fields where applicable. |
| estimated / award value | number | Yes | Published procurement value fields where available. |
| award information | object | Yes | Award/result information when present in the source notice. |
| source provenance | string/object | No | TED/source identifiers and provenance retained for traceability. |
| data_quality_status | string | No | DModify QA result. |
| record_version_id | string | No | DModify record-version identifier. |
federal-contract-opportunities · schema v1.0.0
Core field dictionary.
SAM.gov Contract Opportunities
| Field | Type | Null? | Meaning |
|---|---|---|---|
| notice_id | string | No | SAM.gov opportunity notice identifier. |
| title | string | Yes | Opportunity title. |
| solicitation_number | string | Yes | Solicitation number where supplied. |
| department_agency_office | string | Yes | Normalized department/agency/office label. |
| department_agency_office_code | string | Yes | Agency/office code where supplied. |
| posted_date | date | Yes | SAM.gov posted date. |
| notice_type | string | Yes | Opportunity notice type. |
| base_type | string | Yes | Base notice type. |
| active | boolean | Yes | Source active-state indicator. |
| response_deadline | datetime/date | Yes | Response deadline where supplied. |
| naics_code | string | Yes | NAICS classification. |
| psc_code | string | Yes | Product/service code. |
| set_aside_code | string | Yes | Set-aside code. |
| set_aside_description | string | Yes | Set-aside description. |
| point_of_contact | object/string | Yes | Published point-of-contact information. |
| place_of_performance | object/string | Yes | Published place of performance. |
| description | string | Yes | Opportunity description. |
| sam_url | URI | Yes | SAM.gov source URL. |
| source_system | string | No | Source system identifier. |
| source_api | string | No | Source API identifier. |
| processed_at | datetime | No | DModify processing timestamp. |
| record_version_id | string | No | DModify record-version identifier. |
| data_quality_status | string | No | DModify QA result. |
| data_quality_messages | array | No | QA messages. |
| change_type | string | No | DModify change classification. |
federal-contracts
Core field dictionary.
U.S. Federal Contract Awards
| Field | Type | Null? | Meaning |
|---|---|---|---|
| generated_award_id | string | No | USAspending generated award identifier. |
| award / PIID identifiers | string | Yes | Award identifiers retained from USAspending. |
| recipient | string/object | Yes | Award recipient information. |
| awarding agency | string/object | Yes | Awarding department/agency information. |
| award amount / value | number | Yes | Normalized award value fields from USAspending. |
| action / period dates | date | Yes | Award action and performance-period dates where available. |
| NAICS / PSC | string | Yes | Industry and product/service classifications. |
| place of performance | string/object | Yes | Place-of-performance information where published. |
| source provenance | string/object | No | USAspending source identifiers/provenance. |
| record_version_id | string | No | DModify record-version identifier. |
| data_quality_status | string | No | DModify QA result. |
| data_quality_messages | array | No | QA messages. |
| change_type | string | No | DModify change classification. |
EU TED field coverage.
Buyer and notice identifiers, CPV classification, procedure, publication/deadline dates, estimated value, award information, source provenance, QA state and record versioning.
SAM.gov field coverage.
Notice and solicitation identifiers, agency/office, notice type, posted and response dates, NAICS/PSC, set-aside, point of contact, place of performance, description, source URL, provenance, QA state and record versioning.
Three linked Companies House components.
UK Company Accounts and Company Master are production-ready. Accounts updates follow a daily cadence; Company Master uses monthly releases, with the latest published monthly snapshot displayed by the public API. PSC coverage is separately described by its published delivery metadata. Missing optional API fields do not by themselves indicate that validation is incomplete.
| Component | Core coverage | Status |
|---|---|---|
| uk_company_master | Company number, name, status, type, incorporation, registered office, SIC, accounts/confirmation metadata, provenance and change type. | Production |
| uk_company_accounts | Reporting period, currency, selected financial metrics, explicit nulls, metric provenance, QA and record version. | Production |
| uk_company_psc | PSC kind, name/entity identification, nature of control, notification/cessation dates, restrained public identity fields, QA and record version. | Production |
The public website exposes evaluation samples; complete daily delivery is controlled through authorized API access, while larger monthly archives are handled through enterprise delivery.
Federal Contracts identifier and schema notes
The generated_award_id is the USAspending source lookup identifier used by the x402 exact-record endpoint. The award_id is a field shown in the public preview projection where provided. They must not be assumed interchangeable. Schema v0.1.0 denotes an early versioned contract, not a guarantee of a stable long-term interface. Consult the live schema metadata and applicable integration agreement before production integration.
Sample records may be historical; a current publication date does not imply every award is active today.
Apify marketplace versus DModify subscriptions
Some DModify datasets may also be offered through third-party marketplaces such as Apify. Marketplace charges are calculated according to that marketplace listing (for example, per result or run) and are billed separately from DModify subscriptions. The $49 Individual, $199 Professional and $999 Enterprise monthly plans cover the combined DModify portfolio under their respective access and usage terms; marketplace purchases do not automatically include subscription credentials, higher API quotas, bulk delivery or redistribution rights. Check the current marketplace listing for its actual price and terms.
Public preview fields versus full delivery schemas
Public preview JSON is a deliberately reduced projection of the underlying dataset. A field marked required in the full versioned schema may not be included in the public sample. For SEC Financial Filings, the public preview currently includes total_debt_usd_millions, operating_cash_flow_usd_millions and debt_equity_ratio where available. accession_number and source_filing_url are not exposed in that preview; request delivery-level provenance before relying on those fields in an integration.
SEC insider transactions: nulls and transaction identity
price_per_share_usd and total_value_usd may be null when a price or value is not reported or cannot be reliably determined, including some gifts and non-cash transactions. Zero and null are different. is_10b5_1_plan may be null when plan status is not established; null does not mean false. Similar-looking same-day transactions may be separate filing rows; transaction-level deduplication requires source identifiers, not merely matching visible preview fields. Issuer names are sourced from filings and require issuer-level validation.
Federal Contracts public projection
The public sample exposes award_id; the x402 exact-record lookup requires generated_award_id. These represent different identifier contexts. Current public delivery metadata reports schema 0.1.0; this is a version number, not evidence of an incomplete run. Consult the live run status and generated_at for freshness.