---
title: "Data"
method: GET
path: "/data"
---

# Data

`GET /data`

Provides data related to the COVID-19 in the United Kingdom based on query parameters. The number of records produced per request is limited to 1000. The pagination feature may be activated to obtain additional records.

## Query parameters

- `filters` string
- `structure` string
- `latestBy` string
- `format` 'json' | 'csv' | 'xml'
- `page` integer

## Response `200`

Successful: The response body contains the data.

- Data
  - `length` integer
  - `maxPageLimit` integer
  - `totalRecords` integer
  - `data` object[]
  - `requestPayload` object
    - `structure` object
    - `filters` object[]
      - `identifier` string, required
      - `operator` string, required
      - `value` string, required
    - `page` integer
  - `pagination` object
    - `current` string
    - `next` unknown
    - `previous` unknown
    - `first` string
    - `last` string

## Other responses

- `204` — Successful: The request was successfully processed, but but were no records matching the requested criteria.
- `400` — Resource not found: Incorrect URL or method
- `401` — Unauthorised request: You are not authorised to view the data
- `404` — Not found: Invalid parameter
- `412` — Precondition failed: Invalid query parameter (not structured correctly)
- `413` — Entity too large: Exceeding the maximum number of parameters, either in filters or in structure.
- `417` — Expectation failed: Either the structure if not a correctly formatted JSON, or the value assigned to a filter parameter is not the correct type.
- `422` — Unprocessable entity: Invalid filter parameter
- `429` — Too many requests: Throttling has been activated
- `500` — Server error: Either an internal server error has occurred, or processing the request has taken longer that permitted.

---

[API](https://skmtc.net/uk-health-security-agency/apis/dashboard-api.md) · [All operations](https://skmtc.net/uk-health-security-agency/apis/dashboard-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uk-health-security-agency/dashboard-api/revisions/34dc18987439/schema)