# Orion Data API | Orion Data API v1.3

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

Overview of the Orion Data API, a read-only HTTP API for extracting Devices and sensor data from Orion Data.

The Orion Data API exposes read-only endpoints from the Orion Data platform. Use it to extract Devices and sensor data for custom reporting, analytics, and integrations with other systems.

## Base URL

All endpoints are served from a common base URL:

```
https://api.oriondata.io/api/{endpoint}
```

## Quick start

1. **Generate an API key**

   Sign in to [Orion Data](https://oriondata.io) and open **Account Settings** to generate an API key. See [Authenticate API requests](https://docs.oriondata.io/api/orion-data/v1-3/guides/authentication/) for detail.

2. **Exchange the API key for a bearer token**

   Call the [Generate a bearer token](https://docs.oriondata.io/api/orion-data/v1-3/operations/gettoken/) endpoint with your API key. The response contains a JWT bearer token valid for 7 days.

3. **Call authenticated endpoints**

   Supply the bearer token in the `Authorization` header of every other request:

   ```
   Authorization: Bearer {token}
   ```

## Endpoints

**[Generate a bearer token](https://docs.oriondata.io/api/orion-data/v1-3/operations/gettoken/)**

Exchange an API key for a JWT bearer token.

**[List devices](https://docs.oriondata.io/api/orion-data/v1-3/operations/getuserdevices/)**

Return every Device assigned to the authenticated user.

**[Get sensor data](https://docs.oriondata.io/api/orion-data/v1-3/operations/getsensordata/)**

Return readings for one or more sensors over a period.

**[Get validated sensor data](https://docs.oriondata.io/api/orion-data/v1-3/operations/getvalidatedsensordata/)**

Return readings together with data-quality metadata.

## API reference topics

**[Authentication](https://docs.oriondata.io/api/orion-data/v1-3/guides/authentication/)**

Generate API keys and exchange them for bearer tokens.

**[Conventions](https://docs.oriondata.io/api/orion-data/v1-3/guides/conventions/)**

Date formats, nullable types, and other shared conventions.

**[Pagination](https://docs.oriondata.io/api/orion-data/v1-3/guides/pagination/)**

Retrieve large result sets using the `offset` parameter.

**[Versioning](https://docs.oriondata.io/api/orion-data/v1-3/guides/versioning/)**

Pin a request to a specific API version, and migrate between versions.

**[Rate limiting](https://docs.oriondata.io/api/orion-data/v1-3/guides/rate-limiting/)**

Request rates allowed under each plan.

**[Status codes](https://docs.oriondata.io/api/orion-data/v1-3/guides/status-codes/)**

Status codes returned by the API.

## Support

For API access, plan changes, or general support, contact <support@ewsmonitoring.com>.