---
title: "List datasets"
method: GET
path: "/api/v1/datasets"
tags: ["FAQ"]
---

# List datasets

`GET /api/v1/datasets`

Lists datasets containing answers and corresponding questions. You can choose to list only your own datasets, as well as template datasets, or both. You might need to iterate over multiple pages to obtain all of your datasets.

## Query parameters

- `listMode` 'LIST_MODE_UNDEFINED' | 'ALL' | 'ONLY_TEMPLATE' | 'ONLY_USER'
- `limit` integer
- `cursor` string

## Response `200`

A successful response.

- V1ListDatasetsResponse — A response containing the FAQ datasets that were queried.
  - `datasets` V1Dataset[] — The (paginated) collection of datasets. This can contain both your own datasets as well as template datasets. Template datasets are used as examples and can be found under the `Templates` tab in the [dataset overview of the dashboard](https://dashboard.messagebird.com/knowledge-base/list). You can clone such datasets to kickstart the creation of a dataset that is tailored to your use-case.
    - `datasetId` string, uuid — The unique ID for the dataset.
    - `name` string — The name of the dataset.
    - `createdAt` string, timestamp — The timestamp of dataset creation. Uses the [ISO-8601 standard](https://en.wikipedia.org/wiki/ISO_8601).
    - `updatedAt` string, timestamp — The timestamp of last update. Uses the [ISO-8601 standard](https://en.wikipedia.org/wiki/ISO_8601).
    - `isTemplate` boolean — Whether this dataset is a template dataset or not. Template datasets are used as examples and can be found under the `Templates` tab in the [dataset overview of the dashboard](https://dashboard.messagebird.com/knowledge-base/list). You can clone such datasets to kickstart the creation of a dataset that is tailored to your use-case.
    - `description` string — The optional description of the dataset.
    - `lastTrainedAt` string, timestamp — The timestamp of last model that completed training. Uses the [ISO-8601 standard](https://en.wikipedia.org/wiki/ISO_8601).
  - `limit` integer — The effective limit of the maximum number of datasets that could be returned by the list endpoint. If the `limit` defined in [`ListDatasetsRequest`](#listdatasetsrequest-object) was not set, this value indicates the used limit.
  - `nextCursor` string — The cursor that can be used to query the next paginated collection of results.

## Other responses

- `401` — Returned when the user is not authorized.
- `404` — Returned when the resource does not exist.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/messagebird/apis/faq.md) · [All operations](https://skmtc.net/messagebird/apis/faq/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/messagebird/faq/versions/6af420f89657/schema)