---
title: "List Messages V1"
method: GET
path: "/api/v1/messages"
tags: ["messages"]
---

# List Messages V1

`GET /api/v1/messages`

## Request

- Base URL: `https://www.elocuenti.com`
- URL: `https://www.elocuenti.com/api/v1/messages`
- Auth: HTTP bearer

List messages with offset-based pagination.

## Query parameters

- `limit` integer
- `offset` integer
- `conversation_id` string, nullable
- `id` string, uuid, nullable

## Response `200`

Successful Response

- MessageRecordList
  - `data` MessageRecord[], required
    - `id` string, required
    - `conversation_id` string, required
    - `content` string, nullable, required
    - `direction` string, required: `inbound` (from the customer) or `outbound`.
    - `status` string, required: Delivery status, updated from WhatsApp: sent, delivered, read, failed.
    - `type` string, required
    - `media_url` string, nullable, required
    - `media_mime_type` string, nullable, required
    - `whatsapp_message_id` string, nullable, required
    - `error_code` string, nullable, required
    - `error_message` string, nullable, required
    - `created_at` string, nullable, required
    - `updated_at` string, nullable, required
  - `request_id` string, nullable

## Other responses

- `401`: No autenticado: falta la credencial, es inválida o expiró.
- `403`: Autenticado, pero sin permiso sobre este recurso o tenant.
- `422`: Validation Error
- `429`: Se superó el límite de peticiones del API key o de la IP.
- `500`: Error interno no recuperable por el cliente.

---

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