# List shifts (/api-reference/events/list-shifts)

## List shifts

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

Major market shifts with related items (not necessarily causal).

### Parameters

- `gpu` (query, any): GPU slug or canonical name
- `provider` (query, any)
- `kind` (query, any)
- `type` (query, any): comma-separated shift types; see /v1/events/shifts/definition
- `severity` (query, any)
- `since` (query, any)
- `until` (query, any)
- `limit` (query, integer)
- `cursor` (query, any)
- `top` (query, integer): related items per shift in the list
- `OpenGrid-Version` (header, string): The API version to shape the response for. Default: the version pinned to your key.

### Response `data`

See the Responses page for the envelope.

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

### Example

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