# Retornar detalhes da mensagem

Este endpoint retorna todos os detalhes disponíveis sobre uma mensagem específica.

## URL

/api/v1/messages/message

## Acesso

Deve ser autenticado como servidor utilizando o header `X-Server-API-Key`. Caso não seja 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 mensagem, contendo os dados básicos. Por padrão, não são retornadas expansões. Para obter dados adicionais, envie o parâmetro `_expansions` com os nomes das expansões desejadas ou `true` para todas.

## Message 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">token</span></td><td> </td><td> </td></tr></tbody></table>

### Expansões Disponíveis

Expansões são estruturas aninhadas de outros objetos relacionados à mensagem. Por padrão, nenhuma expansão é retornada, mas você pode usar o parâmetro `_expansions` para incluí-las.

<table border="1" cellpadding="5" cellspacing="0" class="table paramTable" id="bkmrk-expans%C3%A3o-tipo-descri"><thead><tr><th width="35%">Expansão</th><th width="25%">Tipo</th><th width="40%">Descrição</th></tr></thead><tbody><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">inspection</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">plain\_body</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">html\_body</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">attachments</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">headers</span></td><td> </td><td> </td></tr><tr><td><span class="paramTable__name">raw\_message</span></td><td> </td><td> </td></tr></tbody></table>

## Exemplo: Buscar detalhes de uma mensagem com expansões

Este exemplo mostra como solicitar dados adicionais da mensagem utilizando o parâmetro `_expansions`. Você pode passar uma lista com os campos desejados ou `true` para expandir tudo.

### Por ID numérico

```bash
curl -X POST https://app.sender25.com/api/v1/messages/message \
  -H "Content-Type: application/json" \
  -H "X-Server-API-Key: SUA_CHAVE_AQUI" \
  -d '{
    "id": 12345,
    "_expansions": ["status", "plain_body", "html_body", "attachments", "headers"]
  }'
```

### Por Message-ID

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

Se quiser retornar todas as expansões disponíveis, utilize `"_expansions": true`:

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