---
title: "Bulk Lipsync Statuses"
method: GET
path: "/v3/lipsyncs/statuses"
tags: ["Lipsync Batches"]
---

# Bulk Lipsync Statuses

`GET /v3/lipsyncs/statuses`

## Request

- Base URL: `https://api.heygen.com`
- URL: `https://api.heygen.com/v3/lipsyncs/statuses`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns statuses for up to 100 lipsyncs by `lipsync_ids` and/or `batch_ids`: `queued`, `processing`, `completed`, `failed`, or `not_found`. Each entry's id is in `video_id`.

## Query parameters

- `lipsync_ids` string
- `batch_ids` string

## Response `200`

Successful response

- object
  - `data` VideoStatusEntry[]
    - `video_id` string, nullable: Video id. Null for batch items whose video has not been created yet.
    - `status` string, required: Video status (same values as GET /v1/video_status.get), or not_found for unknown/unowned ids.
    - `error` object, nullable: Failure details when status is failed.
    - `batch_id` string, nullable: Set for entries expanded from a batch_id.
    - `item_index` integer, nullable: Set for entries expanded from a batch_id, to correlate items without a video_id yet.
  - `has_more` boolean: Whether more pages are available
  - `next_token` string, nullable: Opaque cursor for the next page

## Other responses

- `400`: Invalid request parameters
- `401`: Authentication failed
- `429`: Rate limit exceeded

## Changes

- **2026-11-03** `7dfa5e59b4f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/heygen/apis/heygen-external-api/changes/v3/lipsyncs/statuses/get.md)

---

[API](https://skmtc.dev/heygen/apis/heygen-external-api.md) - [All operations](https://skmtc.dev/heygen/apis/heygen-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/heygen/apis/heygen-external-api/revisions/7dfa5e59b4f5?raw)