---
title: "list datasets"
method: GET
path: "/api/v1/datasets"
tags: ["Intent"]
---

# list datasets

`GET /api/v1/datasets`

Lists datasets containing intents and corresponding phrases. You can choose to list only your own datasets, as well as template datasets, or both. 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. 

Note that the results are paginated and so you might need to iteratively call this endpoint to obtain all your datasets.

## Query parameters

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

## Response `200`

A successful response.

- V1ListDatasetsResponse — A response containing the Intent 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.
    - `intents` string[] — The collection of intents that were added to this dataset.
    - `isTemplate` boolean — Describes if 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.
    - `name` string — The name of the dataset. You can configure the name once creating a dataset in the [dashboard](https://dashboard.messagebird.com/knowledge-base/list).
    - `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).
    - `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). If there is not a model trained already, this field will not be populated.
  - `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 obtain the next paginated collection of datasets.

## 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/intent.md) · [All operations](https://skmtc.net/messagebird/apis/intent/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/messagebird/intent/versions/b1f6facbe19c/schema)