# Get latest SMS from phone number

Retrieves the delivery status of the latest messages sent to a given phone number.

Endpoint: GET /messagestatus/phonenumber/{phonenumber}
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `phonenumber` (string, required)
    Phone number in E.164 format (e.g., +1234567890).
    Example: "+1234567890"

## Query parameters:

  - `sendDate` (string)
    Filter messages sent before this timestamp (ISO 8601 format, e.g. 2026-12-31T23:59:59Z). Defaults to current time if not specified.

  - `count` (integer)
    Maximum number of records to return (max 100)

## Response 200 fields (application/json):

  - `messages` (array)
    List of SMS message statuses.

  - `messages.message` (object)
    SMS message status

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

  - `messages.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.

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

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

  - `messages.message.reference.key` (string)
    Custom tracking key (e.g., user ID, order ID).

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

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

  - `messages.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.

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

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

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

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

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

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

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

  - `messages.message.sms` (object)
    SMS info

  - `messages.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 400 fields

## Response 403 fields

## Response 500 fields