REST API overview

The Dataflow REST API serves bulk ownership data over plain HTTPS GET requests against https://dataflow.modularfinance.com/api/.

Authentication

Every request carries your access key, either as a header or a query parameter:

curl -H "X-Dataflow-Key: $DATAFLOW_KEY" \
  "https://dataflow.modularfinance.com/api/entities/company?countries=se"

Array parameters repeat the key: ?countries=se&countries=no.

Keys are issued per contract. Rate limits apply per customer; the default is 60 requests per minute.

Output formats

All data endpoints support three formats, selected with the Accept header or a format query parameter:

• application/json (default, streamed on large endpoints)
• text/csv (streamed)
• application/xml

Your API surface is contract-defined

Which endpoints, parameters and fields you can use is defined by your contract's policies, and the API tells you itself:

• GET /resources/list?key=…: lists your active resources and the ones available in preview.
• GET /resources/open-api?key=…: your personal OpenAPI 3.0 spec, matching your contract exactly. YAML by default; send Accept: application/json for JSON.

Endpoint reference

Every endpoint is documented in the REST reference section in the sidebar. Parameters and response fields are generated from the API's own definitions, so they always match the current API version. Remember that your personal surface is the contract-filtered subset: your OpenAPI spec from /resources/open-api is authoritative for your key.