---
title: "Consultar mensagem do histórico"
method: GET
path: "/dashboard/messages/{id}"
tags: ["Mensagens"]
---

# Consultar mensagem do histórico

`GET /dashboard/messages/{id}`

## Request

- Base URL: `https://api.ararahq.com`
- URL: `https://api.ararahq.com/dashboard/messages/{id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ararahq/apis/ararahq-api/docs/dashboard/messages/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Diferente de `GET /v1/messages/{id}`, vale para qualquer mensagem da
organização e inclui variáveis e corpo. Permissão: `ADMIN`.

## Path parameters

- `id` string, required

## Response `200`

Detalhe

- DashboardMessageDetail
  - `id` string
  - `status` 'PENDING' | 'SCHEDULED' | 'PROCESSING' | 'SENT_TO_PROVIDER' | 'SENT' | 'DELIVERED' | 'READ' | 'FAILED' | 'CANCELED'
  - `mode` string
  - `sender` string
  - `receiver` string
  - `messageType` string
  - `templateName` string
  - `templateSid` string
  - `templateLanguage` string
  - `providerSid` string
  - `errorDetails` string
  - `scheduledAt` string
  - `externalReference` string
  - `deliveredAt` string
  - `readAt` string
  - `createdAt` string
  - `updatedAt` string
  - `cost` number
  - `templateVariablesJson` string
  - `body` string
  - `processedContent` string
  - `mediaUrl` string
  - `direction` string
  - `processingStart` string
  - `processingEnd` string

## Other responses

- `401`: Chave inexistente, revogada, expirada, com prefixo errado (`ara_` sem `ara_live_`) ou vinda de IP fora da allowlist. O corpo é o JSON padrão do Spring, sem `error.code`.
- `403`: Dois casos, com corpos diferentes: - Autenticação: header `Authorization` ausente, Bearer que não começa com `ara_`, chave sem a permissão da rota ou rota que não aceita chave de API. Corpo no formato padrão do Spring, sem `error.code`. - Regra de negócio, no formato `{ "error": { ... } }`: `PLAN_FEATURE_LOCKED`, `PLAN_LIMIT_REACHED`, `ACCOUNT_NOT_ACTIVATED`, `NO_DEDICATED_NUMBER`, `ORGANIZATION_SUSPENDED`, `NUMBER_BLOCKED`, `FRAUD_SUSPECTED`, `RESOURCE_FORBIDDEN`, `VIEWER_READ_ONLY`.
- `404`: Não encontrada. Corpo `{ "error": "Message not found" }`.
- `429`: `RATE_LIMIT_EXCEEDED`: limite geral da API (1.200 leituras ou 3.000 escritas por minuto, por usuário da chave).

## Changes

- **2026-10-12** `d576cd28afc0`: 3 info
  - api tag `Mensagens` added
  - api tag `dashboard` removed
  - added the non-success response with the status `429`
- **2026-09-15** `372d8c2e735d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ararahq/apis/ararahq-api/changes/dashboard/messages/:id/get.md)

---

[API](https://skmtc.dev/ararahq/apis/ararahq-api.md) - [All operations](https://skmtc.dev/ararahq/apis/ararahq-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ararahq/apis/ararahq-api/revisions/d576cd28afc0?raw)