---
title: "List channel data points"
method: GET
path: "/v1/channels/{channel_id}/data"
tags: ["Channels"]
---

# List channel data points

`GET /v1/channels/{channel_id}/data`

Get a list of data points for a channel.

> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

## Path parameters

- `channel_id` string, required

## Query parameters

- `page` object
  - `start_cursor` string
  - `limit` integer, nullable
- `filter` object
  - `source_timestamp` object — Filter results based on dates. When passing in operators, the operator pairs are mutually exclusive. For example, you cannot send both `gt` and `gte` in the same request.
    - `gt` string, date-time, nullable — Great than operator
    - `gte` string, date-time, nullable — Great than or equal to operator
    - `lt` string, date-time, nullable — Less than operator
    - `lte` string, date-time, nullable — Less than or equal operator
- `sort` union
  - 'source_timestamp:asc' | 'source_timestamp:desc'
  - string[]

## Response `200`

200

- object
  - `data` object[], required
    - `id` string, required
    - `url` string — The URL of this resource in the Dovetail web app. This field is experimental and may change without notice.
    - `channel` object, required
      - `id` string, required
    - `source_timestamp` string, required
    - `text` string, nullable, required
    - `sentiment` 'POSITIVE' | 'NEGATIVE' | 'MIXED' | 'NEUTRAL', nullable, required
    - `summary` string, nullable, required
    - `source_url` string, nullable, required
    - `themes` object[], required
      - `id` string, required
      - `title` string, required
  - `page` object, required
    - `total_count` number, required — Total number of items matching the query.
    - `has_more` boolean, required — Whether there are more items beyond the current page.
    - `next_cursor` string, nullable, required — Cursor to pass as `page[start_cursor]` to fetch the next page. Null when there are no more results.

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `422` — 422
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/dovetail/apis/dovetail-public-api.md) · [All operations](https://skmtc.net/dovetail/apis/dovetail-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dovetail/dovetail-public-api/versions/4107f5fdf8b2/schema)