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

## List events

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

Market events, newest first.

### Parameters

- `gpu` (query, any): GPU slug or canonical name
- `provider` (query, any)
- `type` (query, any): comma-separated event types
- `severity` (query, any): comma-separated: info, notable, major
- `min_severity` (query, any)
- `since` (query, any)
- `until` (query, any)
- `limit` (query, integer)
- `cursor` (query, any)
- `OpenGrid-Version` (header, string): The API version to shape the response for. Default: the version pinned to your key.

### Response `data`

- `dedupe_key` (string)
- `detail` (object)
  - `basis` (string)
  - `direction` (string)
  - `examples` (array of object)
  - `from` (number)
  - `gpus` (number)
  - `is_cheapest` (boolean)
  - `last_lowest` (number)
  - `last_price` (number)
  - `listings` (number)
  - `live_markets` (number)
  - `lowest` (number)
  - `lowest_provider` (string)
  - `markets` (number)
  - `matched` (boolean)
  - `median` (number)
  - `metric` (string)
  - `previous_price` (number)
  - `previous_provider` (string)
  - `previous_provider_now` (null | number)
  - `price` (number)
  - `priced_listings` (number)
  - `providers` (array | number)
  - `reason` (string)
  - `share` (number)
  - `since` (string)
  - `sold_out_listings` (number)
  - `to` (number)
  - `was_cheapest` (boolean)
- `detected_at` (string)
- `gpu` (null | string)
- `gpu_name` (string)
- `id` (number)
- `kind` (string)
- `occurred_at` (string)
- `pct` (null | number)
- `provider` (null | string)
- `provider_name` (null | string)
- `region_group` (null)
- `segment` (string)
- `severity` (string)
- `title` (string)
- `type` (string)
- `value_after` (null | number)
- `value_before` (null | number)

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

### Example

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