# Get SMS details from message ID

Retrieves the delivery status for a specific message.

Endpoint: GET /messagestatus/{messageid}
Version: 3.1.2.1
Security: ApiKeyAuth

## Path parameters:

  - `messageid` (string, required)
    Message ID to query
    Example: "54149766-7f65-4d02-b29d-406a42ca7a88"

## Response 200 fields (application/json):

  - `message` (object)
    SMS message status

  - `message.id` (string, required)
    Message identifier
    Example: "54149766-7f65-4d02-b29d-406a42ca7a88"

  - `message.reference` (object)
    Tracking reference to correlate SMS with your business logic. May be an empty object ({}) if no reference was specified in the send request.

  - `message.reference.service` (string)
    Service identifier (e.g., AUTHENTICATION, ECOMMERCE, DIGITALSIGN).

  - `message.reference.action` (string)
    Action within the service (e.g., 2FA, PASSWORD_RESET).

  - `message.reference.key` (string)
    Custom tracking key (e.g., user ID, order ID).
    Example: "ref-12345"

  - `message.channel` (string)
    Delivery channel.
    Enum: "SMS", "RCS"

  - `message.status` (string)
    Current delivery status.
    Enum: "SENT", "DELIVERED", "REJECTED", "UNDELIVERED", "READ", "PROVIDER_ACCEPTANCE"

  - `message.providerAcceptanceAt` (string, required)
    Timestamp when the message was accepted by the provider (ISO 8601 format, e.g., 2026-02-12T14:51:00Z). Corresponds to the initial PROVIDER_ACCEPTANCE status.

  - `message.statusChangedAt` (string, required)
    Timestamp of the most recent status change (ISO 8601 format, e.g., 2026-02-12T14:51:05Z).

  - `message.provider` (object)
    SMS provider details

  - `message.provider.name` (string)
    Provider name.

  - `message.provider.id` (string)
    Provider's message identifier.

  - `message.provider.status` (string)
    Provider-specific status.

  - `message.provider.code` (string)
    Provider status/error code.

  - `message.provider.message` (string)
    Optional provider error details (e.g. Number Blocked by Carrier).

  - `message.sms` (object)
    SMS info

  - `message.sms.segments` (integer)
    Number of SMS segments used. Messages exceeding 160 characters (GSM-7) or 70 characters (UCS-2) are split into multiple segments.

## Response 401 fields (application/json):

  - `error` (object)
    Error detail

  - `error.code` (integer)
    Machine-readable error code.
    Enum: 1, 2, 3

  - `error.message` (string)
    Human-readable error message.

## Response 403 fields (application/json):

  - `error` (object)
    Error detail

  - `error.code` (integer)
    Machine-readable error code.
    Enum: 1, 2, 3

  - `error.message` (string)
    Human-readable error message.

## Response 404 fields (application/json):

  - `error` (object)
    Error detail

  - `error.code` (integer)
    Machine-readable error code.
    Enum: 1, 2, 3

  - `error.message` (string)
    Human-readable error message.


## Response 400 fields

## Response 500 fields