API versions and deprecation

The Orion Data API is versioned so that new features can be introduced without breaking existing integrations.

Selecting a version

Specify the version as a query parameter:

?version={version}

For example:

GET https://api.oriondata.io/api/sensorData?version=1.3

If no version is supplied, requests default to the lowest available version. At time of writing, this is version 1.1.

Pin your integration to a specific version. Relying on the default exposes you to changes when the lowest-supported version moves forward.

Available versions

Version	Released	Notes
1.1	2022-10-03	Initial release.
1.2	2024-09-16	Added Get validated sensor data.
1.3	2025-05-19	Changed startDate and endDate on the sensor-data endpoints from Date to DateTime. The time portion is optional, so existing implementations continue to work.

Deprecation

When an endpoint is deprecated it continues to function for a grace period, with a warning issued via response headers or documentation. After the grace period, deprecated endpoints stop accepting requests and return 404 Not Found.

Migrate to the latest version of any endpoint as soon as practical after a deprecation is announced.