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

# Get SMS

> Retrieve the status and details of an SMS message.

## Request Headers

<ParamField header="Authorization" type="string" required>
  Bearer token. Format: `Bearer nc_live_your_api_key`
</ParamField>

## Path Parameters

<ParamField path="message_id" type="string" required>
  The unique message ID returned when the SMS was sent.
</ParamField>

## Response

<ResponseField name="message_id" type="string">
  Unique message identifier.
</ResponseField>

<ResponseField name="account_id" type="string">
  Your account ID.
</ResponseField>

<ResponseField name="to" type="string">
  Recipient phone number in E.164 format.
</ResponseField>

<ResponseField name="from" type="string">
  Sender ID used for this message.
</ResponseField>

<ResponseField name="template_id" type="string">
  Notvis template ID, if used.
</ResponseField>

<ResponseField name="dlt_template_id" type="string">
  DLT template ID, if used.
</ResponseField>

<ResponseField name="dlt_entity_id" type="string">
  DLT entity ID, if used.
</ResponseField>

<ResponseField name="variables" type="object">
  Template variables used.
</ResponseField>

<ResponseField name="callback_url" type="string">
  Delivery webhook URL, if set.
</ResponseField>

<ResponseField name="tags" type="string[]">
  Tags attached to this message.
</ResponseField>

<ResponseField name="metadata" type="object">
  Custom metadata attached to this message.
</ResponseField>

<ResponseField name="status" type="string">
  Current status. One of: `queued`, `scheduled`, `sending`, `sent`, `delivered`, `failed`, `undelivered`, `expired`.
</ResponseField>

<ResponseField name="created_at" type="string">
  ISO 8601 timestamp of when the message was created.
</ResponseField>

<Note>
  Message data is available for 7 days after creation. After that, the message expires from the cache.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl https://api.notvis.com/v1/sms/messages/7c9e6679-7425-40de-944b-e07fc1f90ae7 \
    -H "Authorization: Bearer nc_live_your_api_key"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://api.notvis.com/v1/sms/messages/7c9e6679-7425-40de-944b-e07fc1f90ae7',
    { headers: { 'Authorization': 'Bearer nc_live_your_api_key' } }
  );
  const message = await response.json();
  console.log(message.status);
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.notvis.com/v1/sms/messages/7c9e6679-7425-40de-944b-e07fc1f90ae7',
      headers={'Authorization': 'Bearer nc_live_your_api_key'},
  )
  print(response.json()['status'])
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "message_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "account_id": "acc_123",
    "to": "+919876543210",
    "from": "NOTVIS",
    "dlt_template_id": "1107161234567890",
    "dlt_entity_id": "1101234567890",
    "variables": { "1": "123456", "2": "10 minutes" },
    "callback_url": "https://example.com/webhooks/sms",
    "tags": ["otp"],
    "metadata": { "user_id": "usr_123" },
    "status": "delivered",
    "created_at": "2026-07-12T10:00:00Z"
  }
  ```

  ```json 404 Not Found theme={null}
  {
    "code": 404,
    "message": "message not found"
  }
  ```
</ResponseExample>