---
title: "List backtests"
method: GET
path: "/v2/auth_rules/{auth_rule_token}/backtests"
tags: ["Auth Rules"]
---

# List backtests

`GET /v2/auth_rules/{auth_rule_token}/backtests`

Lists backtests for an Auth Rule

## Path parameters

- `auth_rule_token` string, uuid, required

## Query parameters

- `ending_before` string, uuid
- `page_size` integer
- `starting_after` string, uuid

## Response `200`

Backtests

- object
  - `data` BacktestListItem[], required
    - `backtest_token` string, uuid, required — Auth Rule Backtest Token
    - `simulation_parameters` BacktestSimulationParameters, required
      - `start` string, date-time, required — The start time of the simulation
      - `end` string, date-time, required — The end time of the simulation
    - `status` 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILURE', required — Status of a backtest job
    - `created` string, date-time, required — Timestamp of when the backtest was created
  - `has_more` boolean, required — Indicates whether there are more backtests to be retrieved by paging through the results.

## Other responses

- `400` — Bad Request
- `404` — Not Found

---

[API](https://skmtc.net/lithic-com/apis/lithic-developer-api.md) · [All operations](https://skmtc.net/lithic-com/apis/lithic-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lithic-com/lithic-developer-api/versions/53ab5d4e2adb/schema)