# API versions and deprecation | Orion Data API v1.3

> For the complete documentation index, see [llms.txt](https://docs.oriondata.io/llms.txt)

How to target a specific Orion Data API version and how deprecated endpoints are retired.

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`.

> **Tip:**
>
> 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](https://docs.oriondata.io/api/orion-data/v1-3/operations/getvalidatedsensordata/).                                              |
| 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.