---
title: "Cheap progress poll (completed | running | failed | cancelled)"
method: GET
path: "/v1/backtests/{id}/status"
---

# Cheap progress poll (completed | running | failed | cancelled)

`GET /v1/backtests/{id}/status`

## Request

- Base URL: `https://app.texttoquant.com/api`
- URL: `https://app.texttoquant.com/api/v1/backtests/{id}/status`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

## Path parameters

- `id` string, uuid, required

## Response `200`

Success

- object
  - `success` true, required
  - `data` object, required
    - `analysisId` string
    - `status` 'completed' | 'running' | 'failed' | 'cancelled'
    - `stage` string, nullable
    - `percent` number, nullable

## Other responses

- `404`: not_found (unknown id or progress window expired)

---

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