---
title: "Retrieve send request status"
method: GET
path: "/message-requests/{requestEventId}/status"
tags: ["Delivery"]
---

# Retrieve send request status

`GET /message-requests/{requestEventId}/status`

## Request

- Base URL: `https://platform-api.visitoai.com/m2m/v1`
- URL: `https://platform-api.visitoai.com/m2m/v1/message-requests/{requestEventId}/status`
- Auth: HTTP bearer

Use to reconcile an accepted reply, WhatsApp template or conversation start, including preparation failures and sends not yet materialized as messages. Use get_message_status with a returned stored messageId for a single message's delivery. Requires `messages:read`. Use requestEventId from reply/template acceptance. messages may be empty while queued. For multiple messages, inspect each message status; top-level status is unknown.

## Path parameters

- `requestEventId` string, required

## Response `200`

Success

- MessageRequestStatus
  - `requestEventId` string
  - `replyId` string
  - `conversationId` string
  - `acceptedAt` string, date-time
  - `status` 'received' | 'queued' | 'sent' | 'delivered' | 'read' | 'failed' | 'blocked' | 'partial_sent' | 'unknown'
  - `messages` MessageStatus[]
    - `messageId` string
    - `conversationId` string
    - `requestEventId` string
    - `direction` 'inbound' | 'outbound'
    - `status` 'received' | 'queued' | 'sent' | 'delivered' | 'read' | 'failed' | 'blocked' | 'partial_sent' | 'unknown'
    - `externalMessageId` string
    - `deliveries` object[]
      - `externalMessageId` string
      - `status` 'received' | 'queued' | 'sent' | 'delivered' | 'read' | 'failed' | 'blocked' | 'partial_sent' | 'unknown'
    - `errorCode` string: Optional sanitized media preparation error code when preparation failed.
  - `errorCode` string: Optional sanitized media preparation error code when preparation failed.

## Other responses

- `default`: Structured error

---

[API](https://skmtc.dev/visitoai/apis/visito-m2m-api.md) - [All operations](https://skmtc.dev/visitoai/apis/visito-m2m-api/llms.txt) - [OpenAPI document](https://skmtc.dev/visitoai/apis/visito-m2m-api/revisions/98377d35c234?raw)