# Shift definition (/api-reference/events/shift-definition)

## Shift definition

`GET https://data.tryopengrid.com/v1/events/shifts/definition`

How a major shift is defined and its items ranked.

### Parameters

- `OpenGrid-Version` (header, string): The API version to shape the response for. Default: the version pinned to your key.

### Response `data`

- `heading` (string)
- `items_version` (string)
- `note` (string)
- `ranking` (string)
- `segment` (string)
- `thresholds` (object)
  - `archived_min` (number)
  - `baseline_days` (number)
  - `baseline_min_hours` (number)
  - `index_min` (number)
  - `k_times_rms` (number)
  - `major` (string)
  - `median_min` (number)
  - `median_min_providers` (number)
  - `reprice_min_gpus` (number)
- `types` (object)
  - `archived_price_change` (object)
  - `archived_provider_repricing` (object)
  - `capacity_collapse` (object)
  - `index_move` (object)
  - `market_median` (object)
  - `provider_repricing` (object)
- `version` (string)
- `window` (object)
  - `after_hours` (number)
  - `archived_pad_days` (number)
  - `before_hours` (number)
  - `max_items` (number)
  - `settle_days` (number)

Every success is `{"data": ..., "meta": {as_of, api_version, request_id, next_cursor?}}`.

### Example

```bash
curl "https://data.tryopengrid.com/v1/events/shifts/definition" \
  -H "Authorization: Bearer $OPENGRID_API_KEY"
```