> ## Documentation Index
> Fetch the complete documentation index at: https://docs.modawer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get message status

> Requires the requesting customer app token. Returns the latest delivery status and known receipt timestamps without message content.



## OpenAPI

````yaml /v1.json get /messages/{messageId}/status
openapi: 3.1.1
info:
  title: Modawer.Api | v1
  version: 1.0.0
servers:
  - url: https://modawer.com/api
security: []
tags:
  - name: Messages
paths:
  /messages/{messageId}/status:
    get:
      tags:
        - Messages
      summary: Get message status
      description: >-
        Requires the requesting customer app token. Returns the latest delivery
        status and known receipt timestamps without message content.
      operationId: getMessageStatus
      parameters:
        - name: messageId
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: X-API-KEY
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Current message status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetMessageStatusResponse'
        '400':
          description: Invalid message ID
        '401':
          description: Missing or invalid app token
        '404':
          description: Message not found or belongs to another app
components:
  schemas:
    GetMessageStatusResponse:
      type: object
      required:
        - messageId
        - status
        - createdAt
      properties:
        messageId:
          type: string
          format: uuid
        status:
          $ref: '#/components/schemas/MessageStatus'
        deliveryChannel:
          type:
            - string
            - 'null'
          enum:
            - WhatsApp
            - Telegram
            - null
        createdAt:
          type: string
          format: date-time
        sentAt:
          type:
            - string
            - 'null'
          format: date-time
        deliveredAt:
          type:
            - string
            - 'null'
          format: date-time
        readAt:
          type:
            - string
            - 'null'
          format: date-time
        failedAt:
          type:
            - string
            - 'null'
          format: date-time
        failureCode:
          type:
            - string
            - 'null'
        failureReason:
          type:
            - string
            - 'null'
    MessageStatus:
      type: string
      enum:
        - Pending
        - Sent
        - Delivered
        - Read
        - Warning
        - Failed

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.