---
title: "Submits a filter query for a Census 2021 dataset"
method: POST
path: "/filters/{id}/submit"
tags: ["Public"]
---

# Submits a filter query for a Census 2021 dataset

`POST /filters/{id}/submit`

## Request

- Base URL: `/v1` (relative, and the document’s source URL is not known)
- URL: `/v1/filters/{id}/submit`
- Auth: none declared

## Path parameters

- `id` string, required

## Response `202`

Query was submitted successfully

- SubmitFilterResponse
  - `instance_id` string
  - `filter_id` string
  - `dataset` Dataset: A version of an edition for a dataset to filter on.
    - `id` string: The unique identifier of a dataset
    - `edition` string: An edition of a dataset
    - `version` integer: A version of a dataset
  - `links` FilterLinks: A list of links related to this resource
    - `version` object
      - `href` string: A URL to the version being filtered
      - `id` string: An ID of the version being filtered
    - `self` object
      - `href` string: A URL to the filter
      - `id` string: An ID of the version being filtered
    - `dimensions` object
      - `href` string: A URL to the dimensions list
  - `population_type` string

## Other responses

- `500`: Failed to process the request due to an internal error

---

[API](https://skmtc.dev/office-of-national-statistics/apis/cantabular-filter-flex-api.md) - [All operations](https://skmtc.dev/office-of-national-statistics/apis/cantabular-filter-flex-api/llms.txt) - [OpenAPI document](https://skmtc.dev/office-of-national-statistics/apis/cantabular-filter-flex-api/revisions/e753ac2d26bd?raw)