> ## Documentation Index
> Fetch the complete documentation index at: https://docs.telepatia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Sessões de Scribe

> Recuperar o status e os metadados de uma sessão de scribe

Uma sessão de scribe é criada quando um médico realiza uma consulta através da interface da Telepatia. Quando a sessão é finalizada, aqui você consulta o ciclo de vida e os metadados da consulta, e em seguida busca o registro preenchido no endpoint de [Documentos de Registro Médico](/pt-BR/scribe-api/medical-record-documents).

## Ciclo de vida da sessão

Uma sessão passa por vários estados. Os valores abaixo são retornados literalmente no campo `status`.

| Status                | Fase         | Descrição                                                                            |
| --------------------- | ------------ | ------------------------------------------------------------------------------------ |
| `created`             | em andamento | Sessão aberta, gravação ainda não começou                                            |
| `recording`           | em andamento | O médico está gravando ativamente a consulta                                         |
| `stopped`             | em andamento | Gravação encerrada; o áudio está sendo enviado e colocado na fila para processamento |
| `processing`          | em andamento | Pipeline de IA (transcrição + geração do registro) rodando                           |
| `completed`           | **pronto**   | Pipeline finalizado — os documentos estão disponíveis                                |
| `completedWithErrors` | **pronto**   | Pipeline finalizado com erros não fatais — os documentos continuam disponíveis       |
| `reviewed`            | **pronto**   | O médico revisou e finalizou o registro                                              |
| `error`               | terminal     | Erro fatal no processamento — nenhum documento será produzido                        |
| `cancelled`           | terminal     | O usuário cancelou a sessão                                                          |
| `unknown`             | —            | Valor padrão quando o estado upstream não é reconhecido                              |

## Recuperar uma sessão

Use o `consultationInternalId` que você forneceu (ou recebeu) ao configurar o contexto de consulta:

```bash theme={null}
curl https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345 \
  -H "Authorization: Bearer SUA_CHAVE_API"
```

**Resposta:**

```json theme={null}
{
  "id": "ss_a1b2c3d4e5f6g7h8",
  "status": "completed",
  "createdAt": "2026-02-20T10:00:00Z",
  "completedAt": "2026-02-20T10:30:00Z",
  "patientName": "John Doe",
  "scribeSessionModality": "IN_PERSON",
  "consultationInternalId": "CONSULT-12345",
  "specialty": "Cardiology"
}
```

Este endpoint retorna apenas metadados de ciclo de vida e da consulta. O registro preenchido — e seus códigos de diagnóstico ICD — é obtido no endpoint de [Documentos de Registro Médico](/pt-BR/scribe-api/medical-record-documents).

<Tip>
  Enquanto `status` estiver em andamento (`created`, `recording`, `stopped`, `processing`), faça polling nesse endpoint até chegar a um estado pronto (`completed`, `completedWithErrors`, `reviewed`) antes de buscar o registro preenchido. `error` e `cancelled` são estados terminais — nenhum documento será produzido.
</Tip>

## Recuperar o registro preenchido

Este endpoint retorna apenas o ciclo de vida e os metadados da consulta. O registro preenchido — a saída dos templates da sessão, com todas as seções — é obtido separadamente no endpoint de documentos de registro médico, usando o mesmo `consultationInternalId`:

```bash theme={null}
curl https://scribe-api.telepatia.ai/v1/scribe-sessions/CONSULT-12345/medical-record-documents \
  -H "Authorization: Bearer SUA_CHAVE_API"
```

Uma sessão pode produzir mais de um documento (um por `purpose` — ex.: `primary` para o registro do médico, `rpa` para injeção no EMR). Filtre com `?purpose=primary` para obter apenas o principal. Veja [Documentos de Registro Médico](/pt-BR/scribe-api/medical-record-documents) para o formato completo da resposta e a referência de campos.