API versioning and deprecation policy

FinData API endpoints use a major version in the URL, currently /v1/. Backward-compatible additions may appear within a major version. Breaking changes to documented requests or responses will use a new major version.

Deprecation and sunset

Before retiring a stable major API version, FinData will publish a migration guide, announce the deprecation in the API documentation, and provide at least 90 days notice before the published sunset date. Affected responses will use the Deprecation and Sunset headers and a Link header pointing to the policy or migration guidance. No version retirement is currently scheduled.

Emergency security or legal issues may require faster changes; we will communicate the impact and available migration steps as soon as possible. Data availability can change independently of the API version as source filings and coverage change.

API documentation ยท Contact FinData