# Get a provider (/api-reference/reference/get-a-provider)

## Get a provider

`GET https://data.tryopengrid.com/v1/providers/{provider}`

One provider: catalog, pricing vs market, rank history, health.

### Parameters

- `provider` (path, required, string): Provider id, e.g. `lambda`.
- `days` (query, integer)
- `OpenGrid-Version` (header, string): The API version to shape the response for. Default: the version pinned to your key.

### Response `data`

- `beats_the_market` (array of object)
  - `basis` (string)
  - `gpu` (string)
  - `gpu_name` (string)
  - `premium` (number)
- `catalog` (array of object)
  - `gpu` (string)
  - `gpu_name` (string)
  - `listings` (object)
  - `market` (object)
  - `premium_now` (null | number)
  - `price_per_gpu_hour` (null | number)
  - `rank_now` (null | number)
  - `region_groups` (array of string)
  - `window` (object)
- `coverage` (object)
  - `architectures` (array of string)
  - `gpu_ids` (array of string)
  - `gpus` (number)
  - `listings` (object)
  - `region_groups` (array of string)
- `expensive` (array of object)
  - `basis` (string)
  - `gpu` (string)
  - `gpu_name` (string)
  - `premium` (number)
- `facts` (array of string)
- `feed_health` (object)
  - `avg_latency_ms_24h` (null)
  - `failure_rate_24h` (number)
  - `fetches_24h` (number)
  - `last_fetch` (string)
  - `last_ok_fetch` (string)
  - `reason` (null)
- `listing_lifetime` (object)
  - `label` (string)
  - `listings` (number)
  - `median_hours` (number)
  - `reason` (null)
- `note` (string)
- `provider` (string)
- `provider_class` (string)
- `provider_name` (string)
- `rank_distribution` (object)
- `rank_history` (array of object)
  - `availability` (number)
  - `cheapest_share` (null | number)
  - `day` (string)
  - `hours_compared` (number)
  - `hours_market` (number)
  - `mean_rank` (null | number)
  - `premium_avg` (null | number)
  - `top3_share` (null | number)
- `relative_value` (object)
  - `availability` (number)
  - `cheapest_share` (number)
  - `premium_avg` (number)
  - `reasons` (object)
  - `samples` (object)
  - `top3_share` (number)
  - `volatility_daily` (number)
- `source` (string)
- `source_type` (string)
- `website` (string)

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

### Example

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