# 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: 3.1.2.1
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header X-Api-Key

## Path parameters:

  - `phonenumber` (string, required)
    Phone number in E.164 format (e.g., +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:

  - `200` (unknown)
    SMS list for phone number

## 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).
    Example: ref-12345

  - `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:

  - `400` (unknown)
    Bad request

## Response 400 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 401:

  - `401` (unknown)
    Unauthorized. Empty or missing api-key.

## 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:

  - `403` (unknown)
    Forbidden. Invalid path.

## 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 500:

  - `500` (unknown)
    Internal server error

## Response 200 examples:

  - `Message with reference` (unknown)

  - `Message without reference (reference not specified in send request)` (unknown)

  - `No messages found` (unknown)

## Response 400 examples:

  - `Invalid sendDate format` (unknown)

  - `count out of range` (unknown)

