# List macro series (/api-reference/macro/list-macro-series)

## List macro series

`GET https://data.tryopengrid.com/v1/macro/series`

Market-context series: the catalogue.

### Parameters

- `source` (query, any)
- `entity` (query, any)
- `geo` (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`

- `attribution` (string)
- `enabled` (boolean)
- `entity` (null)
- `frequency` (string)
- `geo` (string)
- `latest` (null)
- `market_area` (null | string)
- `name` (string)
- `points` (number)
- `series_id` (string)
- `source` (string)
- `unit` (string)

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

### Example

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