WAwavix
SMS and MMS

Retrieve a message

Changed on

Returns the SMS or MMS message identified by id, including its delivery status and content.

get/v3/messages/{id}

Request

  • Base URL
    https://api.wavix.com
  • URL
    https://api.wavix.com/v3/messages/{id}
  • Auth
    HTTP bearer

Path parameters

idstring uuid required
Example:3a525ca2-6909-4c72-9399-905adf7f3a74

The unique ID of the message.

Response

Returns the message.

message_idstring required

Message ID.

message_typestring required

Message type. Possible values are sms, mms.

fromstring required

Sender ID.

tostring required

Recipient phone number.

directionstring required

Message direction. Possible values are outbound, inbound.

mccstring nullable required

Mobile country code.

mncstring nullable required

Mobile network code.

tagstring nullable required

Tag to group messages, such as for a specific campaign.

status'accepted' | 'pending' | 'sent' | 'delivered' | 'undelivered' | 'expired' | 'rejected' | 'dlr_expired' required

Current delivery status of the message. One of:

  • accepted — the message was accepted by the platform for sending.
  • pending — the message is queued and awaiting a carrier response.
  • sent — the message was handed to the carrier.
  • delivered — the carrier confirmed delivery to the handset.
  • undelivered — the carrier reported that delivery failed.
  • expired — the validity period elapsed before the message was sent.
  • rejected — the message was rejected before sending.
  • dlr_expired — no delivery receipt arrived from the carrier within the expected window.
segmentsinteger required

Number of SMS segments. Always 1 for MMS.

chargestring required

Total charge for the message in USD.

submitted_atstring required

Date and time the message was accepted in ISO 8601 format.

sent_atstring nullable required

Date and time the message was sent in ISO 8601 format. For mobile-terminated messages only.

delivered_atstring nullable required

Date and time the message was delivered in ISO 8601 format. Refers to DLR reception for mobile-terminated messages or webhook relay for mobile-originated messages.

error_messagestring nullable required

Human-readable error message.

carrier_feesstring nullable

Mobile carrier fees in USD.

Example response

{
  "message_id": "871b4eeb-f798-4105-be23-32df9e991456",
  "message_type": "sms",
  "from": "Wavix",
  "to": "447537151866",
  "direction": "outbound",
  "mcc": "301",
  "mnc": "204",
  "message_body": {
    "text": "Hi there, this is a sample message",
    "media": [
      "https://you-site.com/media"
    ]
  },
  "tag": "Fall sale",
  "segments": 1,
  "charge": "0.01",
  "submitted_at": "2022-04-14T13:51:16.096Z",
  "sent_at": "2022-04-14T13:51:16.096Z",
  "delivered_at": "2022-04-14T13:51:16.096Z",
  "carrier_fees": "0.0"
}

Changes

  • 6a89c962481cRevision changes
    • breaking

      added the pattern ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$ to the path request parameter id

    • breaking

      for the path request parameter id, the format changed from no format to uuid

    • breaking

      the response's body type changed from no type to object for status

    • info

      removed subschema #2 from the response body allOf list for the response status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 33be77905120Revision changes
    • info

      the endpoint scheme security bearerAuth was added to the API