---
title: "List Replacements"
method: GET
path: "/v2/replacements"
tags: ["Replacements"]
deprecated: true
---

# List Replacements

`GET /v2/replacements`

## Request

- Base URL: `https://tavusapi.com`
- URL: `https://tavusapi.com/v2/replacements`
- Auth: API key in header `x-api-key`

> **Deprecated.**

This endpoint is no longer supported by Tavus.

This endpoint returns a list of all Replacements created by the account associated with the API Key in use.

## Query parameters

- `limit` integer
- `page` integer

## Response `200`

- object
  - `data` object[]
    - `replacement_id` string: A unique identifier for the replacement.
    - `replacement_name` string: The name of the replacement.
    - `status` string: The status of the replacement. Can be either `started`, `completed`, or `error`.
    - `created_at` string: The date and time the replacement was created.
  - `total_count` integer: The total number of replacements that fit the query.

## Changes

- **2026-11-03** `932c24e63be2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/changes/v2/replacements/get.md)

---

[API](https://skmtc.dev/tavus/apis/tavus-developer-api-collection.md) - [All operations](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/tavus/apis/tavus-developer-api-collection/revisions/932c24e63be2?raw)