# Consultar status da transmissão

Informa se um Cloud Phone está transmitindo ao vivo neste momento.
- **Pré-requisitos**: o telefone precisa pertencer à sua equipe e o serviço dele precisa suportar transmissão ao vivo. Diferente do início e da parada, **não** é necessário que esteja ligado nem reservado por você.
- **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado.
- **Valores**: `liveStatus` é `0` (sem transmissão) ou `1` (transmitindo). **Não existe um estado de falha**: um início que nunca surtiu efeito simplesmente permanece em `0`, portanto limite sua consulta com um timeout.

Erros de negócio documentados: `33300`, `33401`. Consulte [Error Codes](../Getting%20Started/error-codes.md) para o significado de cada código. Qualquer operação também pode retornar os códigos comuns.

Endpoint: POST /api/cloudphone/live/status
Version: 2026-09-05

## Request fields (application/json):

  - `phoneId` (string, required)
    Cloud phone ID
    Example: 190000000000000001

## Response 200:

  - `200` (unknown)
    Request processed; inspect `code` for the business result

## Response 200 fields (application/json):

  - `code` (integer, required)
    Business result code; `0` indicates success
    Example: 0

  - `msg` (string | null, required)
    Error message; null when successful
    Example: null

  - `requestId` (string, required)
    Request ID for troubleshooting
    Example: 1d4f3ea968664593860b94b35d4ebf5e

  - `data` (object, required)

  - `data.liveStatus` (integer)
    Live status (`0` = stopped, `1` = running)
    Enum: "0", "1"

  - `data.writeFileId` (string | null)
    Current file ID, when available

  - `data.liveFilePath` (string | null)
    Current file path or URL, when available