---
agentTools:
  projectIndex: https://docs.asaas.com/llms.txt
---

# Nova URL autenticada para download de consultas Serasa

A partir de **10 de agosto de 2026**, a resposta da API de Consulta Serasa passará a retornar o novo campo `downloadReport`, que deverá ser utilizado para realizar o download autenticado do relatório.

Durante o período de adequação, o campo `downloadUrl` continuará sendo retornado, mas está depreciado.

Exemplo da resposta:

```json
{
  "id": "6c5e73fa-9efd-4a75-b60c-1cafb8d1c7ed",
  "dateCreated": "2025-05-30",
  "cpfCnpj": "05666663755",
  "customer": "cus_000000001766",
  "downloadUrl": "https://www.asaas.com.br/creditBureauReport/download/6c5e73fa-9efd-4a75-b60c-1cafb8d1c7ed",
  "downloadReport": "https://www.asaas.com/api/v3/creditBureauReport/6c5e73fa-9efd-4a75-b60c-1cafb8d1c7ed/download",
  "reportFile": null
}
```

Para acessar o documento por meio do `downloadReport`, será necessário realizar uma requisição `GET` para a URL retornada no campo, enviando uma chave de API válida no cabeçalho `access_token`.

O campo `downloadUrl` e a URL pública associada serão descontinuados em **5 de outubro de 2026**.

Atualize sua integração para utilizar o campo `downloadReport` antes dessa data.