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

## List listings

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

Current price listings: every offer, cheapest first, with provenance.

### Parameters

- `gpu` (query, any)
- `provider` (query, any)
- `region_group` (query, any)
- `market_type` (query, any)
- `available` (query, any)
- `as_of` (query, any): the listings as published at this time (UTC)
- `previous` (query, boolean): add price_change: the price before the newest recorded change
- `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`

- `available` (boolean)
- `capacity` (null)
- `capacity_unit` (null)
- `country` (null | string)
- `currency` (string)
- `first_seen_at` (string)
- `gpu` (string)
- `gpu_count` (number)
- `gpu_name` (string)
- `interruptible` (boolean)
- `listing_id` (string)
- `market_type` (string)
- `observed_at` (string)
- `original` (null)
- `price_change` (null)
- `price_per_gpu_hour` (number)
- `price_per_instance_hour` (number)
- `provider` (string)
- `provider_name` (string)
- `provider_tier` (null)
- `ram_gb` (null)
- `raw_gpu_name` (string)
- `region` (null | string)
- `region_group` (string)
- `sku` (string)
- `storage_gb` (null)
- `trust` (object)
  - `age_seconds` (number)
  - `availability_basis` (string)
  - `confidence` (string)
  - `confidence_reasons` (array of string)
  - `flags` (array)
  - `freshness` (string)
  - `held` (array)
  - `last_changed` (string)
  - `last_fetched` (string)
  - `last_seen` (string)
  - `polling_interval_seconds` (number)
  - `provider_status` (string)
  - `source` (null)
  - `source_detail` (string)
  - `source_type` (string)
- `vcpu` (null)

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

### Example

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