# API - GET nos Relatórios Personalizados

<figure><img src="https://3534414179-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9FzUKkagBNy5uQ7AtGNa%2Fuploads%2FpiresZ4fi0OpvNc3yGzY%2FChatGPT%20Image%20Jun%2030%2C%202025%2C%2011_13_53%20AM.png?alt=media&#x26;token=50e285c7-29bf-4d0a-aca0-c44a94915f8a" alt=""><figcaption></figcaption></figure>

Lembre-se de criar o[ **Relatório Personalizado**](https://docs.sprinthub.com/topicos/analisar/relatorios-e-dashboards-personalizados/relatorios-videos-tutoriais/relatorios-dashboards-e-graficos-personalizados-no-sprinthub) antes!

Os relatórios não são atualizados a todo momento, por isso, para evitar consumidar todas as suas chamadas API/Min, tente chamar o GET no relatório no máximo 3 vezes ao dias.

**Chamada para obter os IDs dos relatórios:**

{% code fullWidth="false" %}

```http
GET /advancedreports?apitoken=seu-api-token&i=instancia
```

{% endcode %}

**Chamada de relatório por ID:**

```http
GET /reportchart/{report_id}?apitoken=seu-api-token&i=instancia
```

**Parâmetros de URL**

* `report_id` (obrigatório): ID do relatório
* `apitoken` (obrigatório): Token de autenticação da API
* `i` (obrigatório): sua instância

**Headers**

```http
Content-Type: application/json
```

### Códigos de Status

| Código | Descrição           | Detalhes                                     |
| ------ | ------------------- | -------------------------------------------- |
| 200    | Sucesso             | A requisição foi bem-sucedida                |
| 400    | Requisição inválida | Verifique os parâmetros enviados             |
| 401    | Não autorizado      | Token inválido ou expirado                   |
| 403    | Acesso proibido     | Sem permissão para acessar o recurso         |
| 404    | Não encontrado      | Recurso solicitado não existe                |
| 500    | Erro interno        | Erro no servidor, tente novamente mais tarde |

### Observações

* Todas as datas devem ser enviadas no formato ISO 8601 (YYYY-MM-DD)
* O token de autenticação deve ser enviado em todas as requisições
* Limite de requisições: verifique o limite do seu plano.
