---
title: "Get a list of options from a dimension (filterable and cantabular datasets only)"
method: GET
path: "/datasets/{id}/editions/{edition}/versions/{version}/dimensions/{dimension}/options"
tags: ["Public"]
---

# Get a list of options from a dimension (filterable and cantabular datasets only)

`GET /datasets/{id}/editions/{edition}/versions/{version}/dimensions/{dimension}/options`

Get a list of options which appear in this dimension and dataset. By default all options are returned, but a subset can be requested by providing offset and limit query parameters, or by providing the list of option IDs, only the IDs that are found will be returned.

## Path parameters

- `dimension` string, required
- `edition` string, required
- `id` string, required
- `version` string, required

## Query parameters

- `limit` integer
- `offset` integer
- `id` string

## Response `200`

Json object containing all options for a dimension

## Other responses

- `400` — Invalid request, reasons can be one of the following: * dataset id was incorrect * edition was incorrect * version was incorrect * dimension was incorrect * query parameters incorrect offset provided * query parameters incorrect limit provided
- `404` — No dimension options were found for dimension
- `500` — Failed to process the request due to an internal error

---

[API](https://skmtc.net/office-of-national-statistics/apis/dataset-api.md) · [All operations](https://skmtc.net/office-of-national-statistics/apis/dataset-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/office-of-national-statistics/dataset-api/revisions/a2947a13d675/schema)