---
url: https://docs.ouvixpro.ai/guia/periodo.md
description: >-
  Parâmetros de, ate e turno: formato das datas, limite de 31 dias e as faixas
  de manhã, tarde e noite.
---

# Período e turno

Os endpoints `/v1/painel`, `/v1/atendimentos/{id}` e `/v1/atendimentos/{id}/audio` exigem o período da consulta. Não há valor padrão: a API não assume "hoje" nem "ontem", para que o resultado seja sempre reproduzível.

## `de` e `ate`

Datas no formato `YYYY-MM-DD`, inclusivas nas duas pontas.

| Consulta | Parâmetros |
| --- | --- |
| Um dia | `de=2026-10-08&ate=2026-10-08` |
| Uma semana | `de=2026-10-02&ate=2026-10-08` |
| Um mês | `de=2026-10-01&ate=2026-10-31` |

* O intervalo máximo é de **31 dias**. Para períodos maiores, divida em chamadas mensais.
* `de` precisa ser menor ou igual a `ate`.
* Em intervalos, os números do `painel` são consolidados e as listas trazem os atendimentos de todos os dias, em ordem de `data_ref` e `horario`.

::: tip Quando consultar
Os dados de um dia ficam prontos na madrugada seguinte, depois do processamento das gravações. Consultas ao dia corrente podem voltar incompletas.
:::

## `turno`

Parâmetro opcional para recortar o período por faixa de horário. Sem ele, a API devolve o dia inteiro.

| `turno` | Faixa |
| --- | --- |
| `todos` (padrão) | O período inteiro. |
| `manha` | 06:00 – 11:59 |
| `tarde` | 12:00 – 16:59 |
| `noite` | 17:00 – 22:00 |

```bash
curl "https://api.ouvixpro.ai/v1/painel?Id_unidade=375&de=2026-10-08&ate=2026-10-08&turno=tarde" \
  -H "Authorization: Bearer $OUVIX_API_KEY"
```

O filtro vale para todos os blocos do `painel`: contadores, listas e insights refletem só o turno pedido. A resposta repete o turno aplicado no campo `turno`.

## Período em `/v1/atendimentos/{id}` e no áudio

O `id` de um atendimento só é resolvido **dentro do `Id_unidade` e do período informados**. Use o mesmo `de` / `ate` (e `turno`) da chamada ao `/v1/painel` que devolveu o atendimento; fora desse recorte a resposta é `404 atendimento_nao_encontrado`.

## Erros relacionados

| HTTP | `code` | Causa |
| --- | --- | --- |
| 400 | `data_obrigatoria` | `de` ou `ate` não informados. |
| 400 | `periodo_invalido` | Data inválida, `de` maior que `ate`, ou intervalo acima de 31 dias. |
| 400 | `turno_invalido` | Valor fora de `todos`, `manha`, `tarde`, `noite`. |