SMS API Logs

The SMS API Logs page lets you search and troubleshoot SMS messages sent through the SMS API. Use this page to investigate delivery issues, verify message status, and download logs for further analysis.

Note: If you send SMS traffic through the Messages API, use the Messages API Logs instead.

Before You Begin

  • SMS logs are available for 30 days only
  • For logs older than 30 days, use the Reports API
  • There's a delay of a few minutes before logs appear
  • Set up a Delivery Receipt webhook for real-time status updates

Accessing SMS Logs

  1. Log in to the Vonage API Dashboard
  2. Navigate to SMS API Logs
SMS Logs

Search Methods

The SMS API Logs page offers five search methods:

Time Range

Search messages within a specific time period to investigate performance or monitor traffic.

Available filters:

  • Time range - Last hour, Last 24 hours, Last 7 days, Last 30 days, or Custom range
  • Direction - Outbound or Inbound messages

Phone Number

Search for messages sent to or from specific phone numbers to investigate customer issues or verify delivery to a particular recipient.

Available filters:

  • 'To' Number - The destination phone number
  • From - The sender ID or phone number
  • Time range - When the message was sent
  • Direction - Outbound or Inbound

Tip: Use the international format (country code + number) for phone numbers.

Message ID

Search for one or more specific messages using their unique message IDs. This method is ideal when you have message IDs from API responses or webhooks.

Available filters:

  • Message IDs - One or more comma-separated message IDs
  • Direction - Outbound or Inbound

Webhook

Troubleshoot delivery receipt (DLR) callbacks and inbound message webhooks to ensure your application is receiving status updates correctly.

Available filters:

  • Direction - Outbound callback (DLR status) or Inbound callback
  • Time range - When the webhook was sent
  • Recipient number - The phone number for webhook delivery (e.g., 447777889900)

Important: Webhook logs show whether Vonage successfully delivered the callback to your server, not whether your server processed it correctly.

Not Sent

Find messages that were rejected by Vonage's platform before delivery. These messages haven't been scheduled for delivery, have no DLR status, and aren't charged.

Available filters:

  • 'To' Number - The intended destination number
  • From - The sender ID or number
  • Time range - When the message was rejected

Working with Results

SMS Logs

Viewing Log Details

Each log entry shows key information about the message:

  • Message ID - Unique identifier for the message
  • From - Sender ID or phone number
  • To - Destination phone number
  • Status - Delivery status (submitted, delivered, failed, etc.)
  • Time - When the message was sent or status updated
  • Network - Mobile network operator
  • Price - Cost of the message

Click on a log entry to view full details, including error codes and network information.

Downloading Logs

Export search results to CSV for offline analysis or record keeping.

To download logs:

  1. Perform a search using any method
  2. Click Download CSV
  3. The CSV file will include all fields from the search results

Note: CSV downloads are limited to the results displayed. For bulk exports or programmatic access, use the Reports API.

Understanding Log Delays

  • Regular logs: Available within 2-5 minutes after sending
  • Delivery receipts: Depend on network operator timing (seconds to hours)
  • Real-time updates: Use Delivery Receipt webhooks instead

Further Reading