---
title: "GET /index/{uuid}/run_state"
method: GET
path: "/index/{uuid}/run_state"
tags: ["index"]
---

# GET /index/{uuid}/run_state

`GET /index/{uuid}/run_state`

## Request

- Base URL: `https://api.merqube.com`
- URL: `https://api.merqube.com/index/{uuid}/run_state`
- Auth: none declared
- TypeScript: <https://skmtc.dev/merqube/apis/merqube-api/docs/index/:uuid/run_state/get.ts> (a function with typed inputs; its response is checked against the schema)

get the latest run state of the index. May be enhanced in the future to support quering for a given eff_ts (e.g., historically).

## Path parameters

- `uuid` string, required

## Response `200`

OK

- RunState
  - `calculation_start_ts` string
  - `error` string: An error message if status is FAILED
  - `status` 'PENDING_CREATION' | 'SUCCEEDED' | 'FAILED' | 'RUNNING', required: the state of the last index run, if applicable

## Other responses

- `403`: not authorized to see this index namespace
- `404`: index or does not exist

---

[API](https://skmtc.dev/merqube/apis/merqube-api.md) - [All operations](https://skmtc.dev/merqube/apis/merqube-api/llms.txt) - [OpenAPI document](https://skmtc.dev/merqube/apis/merqube-api/revisions/20f47ca36587?raw)