# Retornar entregas de uma mensagem

Este endpoint retorna um array contendo todas as tentativas de entrega realizadas para uma mensagem específica.

## URL

/api/v1/messages/deliveries

## Acesso

Deve ser autenticado como servidor utilizando o header `X-Server-API-Key`. Se não for autorizado, será retornado um erro do tipo `AccessDenied`.

## Parâmetros

<table border="1" cellpadding="5" cellspacing="0" class="table paramTable" id="bkmrk-par%C3%A2metro-tipo-valor"><thead><tr><th width="40%">Parâmetro</th><th width="20%">Tipo</th><th width="20%">Valor Padrão</th><th width="20%">Obrigatório</th></tr></thead><tbody><tr><td><span class="paramTable__name">id</span>

O ID numérico da mensagem

</td><td>Integer</td><td>null</td><td>Sim\*</td></tr><tr><td><span class="paramTable__name">msgid</span>

O Message-ID (RFC 822) da mensagem, com ou sem colchetes angulares

</td><td>String</td><td>null</td><td>Sim\*</td></tr><tr><td colspan="4">**\*** Você deve fornecer **OU** `id` **OU** `msgid`. Se ambos forem fornecidos, `id` terá prioridade.

</td></tr></tbody></table>

## Erros

<table border="1" cellpadding="5" cellspacing="0" class="table errorsTable" id="bkmrk-erro-atributos-messa"><thead><tr><th width="50%">Erro</th><th width="50%">Atributos</th></tr></thead><tbody><tr><td><span class="paramTable__name">MessageNotFound</span>

Nenhuma mensagem encontrada com o ID ou Message-ID fornecido

</td><td>- id
    
    O ID da mensagem buscada (quando busca por id)
- msgid
    
    O Message-ID da mensagem buscada (quando busca por msgid)

</td></tr></tbody></table>

## Dados da Resposta

Esta ação retorna uma estrutura de entrega (**Delivery Structure**) contendo os atributos básicos e estendidos relacionados às tentativas de entrega da mensagem.

## Delivery Structure

### Atributos Básicos

<table border="1" cellpadding="5" cellspacing="0" class="table paramTable" id="bkmrk-atributo-tipo-exempl"><thead><tr><th width="35%">Atributo</th><th width="25%">Tipo</th><th width="40%">Exemplo</th></tr></thead><tbody><tr><td><span class="paramTable__name">id</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">status</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">details</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">output</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">sent\_with\_ssl</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">log\_id</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">time</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">timestamp</span></td><td> </td><td> </td></tr></tbody></table>

## Exemplo: Listar entregas de uma mensagem

Esse exemplo mostra como consultar as tentativas de entrega associadas a uma mensagem específica.

### Por ID numérico

```bash
curl -X POST https://app.sender25.com/api/v1/messages/deliveries \
  -H "Content-Type: application/json" \
  -H "X-Server-API-Key: SUA_CHAVE_AQUI" \
  -d '{
    "id": 12345
  }'
```

### Por Message-ID

```bash
curl -X POST https://app.sender25.com/api/v1/messages/deliveries \
  -H "Content-Type: application/json" \
  -H "X-Server-API-Key: SUA_CHAVE_AQUI" \
  -d '{
    "msgid": "uuid-da-mensagem@dominio.com"
  }'
```