---
title: "Get a workflow's holdings"
method: GET
path: "/workflows/{workflow_id}/holdings"
tags: ["Workflows"]
---

# Get a workflow's holdings

`GET /workflows/{workflow_id}/holdings`

## Request

- Base URL: `https://api.indexone.io`
- URL: `https://api.indexone.io/workflows/{workflow_id}/holdings`
- Auth: API key in header `x-api-key` and API key in header `Authorization`

**PLANNED — this route does not exist.** Today: `GET /query?table=index-holdings&pk=idx_...` (or the MCP `get_index_holdings` tool).

The intent is a holdings snapshot with resolved identifiers — shares, weight, price and value per constituent for a given date — rather than the raw stored row.

## Path parameters

- `workflow_id` string, required

## Query parameters

- `time` string
- `map_symbols` boolean

## Response `200`

Intended response: the holdings snapshot.

- object

## Other responses

- `401`: Missing or invalid id token.
- `403`: Caller's teams do not own this workflow.
- `404`: No such workflow, or no holdings at that time.
- `429`: API key usage-plan rate limit exceeded.

---

[API](https://skmtc.dev/indexone/apis/index-one-rest-api.md) · [All operations](https://skmtc.dev/indexone/apis/index-one-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/indexone/apis/index-one-rest-api/revisions/df5a92216a9c?raw)