---
title: "List Data Points"
method: GET
path: "/data_points"
tags: ["Data Points"]
---

# List Data Points

`GET /data_points`

Returns a paginated collection of data points for one or more metrics.
Each data point stores a metric value for a reporting period.
The `date` is always an ISO 8601 calendar date and represents the start of that period.
For investor portfolio metrics using fiscal periods, interpret `date` using the portfolio company's `fiscal_year_end_month`.

## Query parameters

- `metric_id` union, required
  - string, uuid
  - string[]
- `page` integer
- `page_size` integer
- `start_date` string, date
- `end_date` string, date
- `exclude_blank` 'true' | 'false'
- `include_source` 'true' | 'false'

## Response `200`

Successfully retrieved data points

- object
  - `data_points` DataPoint[]
    - `id` string, uuid, required — Unique identifier for the data point
    - `date` string, date, required — Date for this data point (ISO 8601 format)
    - `value` string, required — Value of the metric for this date (stored as string for precision)
    - `metric_id` string, uuid, required — ID of the associated metric
    - `source` DataPointSource — **Experimental.** Provenance information for a data point, derived from the latest version in the changelog. Only included when `include_source=true` is requested.
      - `source_type` 'ai_inbox' | 'update_request' | 'user_provided' | 'unknown', required — Origin of the data point value
      - `label` string, required — Human-readable description of the source
      - `visible_url` string, uri, nullable, required — Deep link to the source in Visible, when available
  - `meta` PaginationMeta
    - `total` integer, required — Total number of items across all pages
    - `total_pages` integer, required — Total number of pages
    - `page` integer, required — Current page number

## Other responses

- `400` — Bad Request - The request is invalid or malformed
- `401` — Unauthorized - Invalid or missing authentication token
- `429` — Too Many Requests - Rate limit exceeded

---

[API](https://skmtc.dev/visible/apis/visible-api.md) · [All operations](https://skmtc.dev/visible/apis/visible-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/visible/visible-api/revisions/a04e0975020f/schema)