Getting Started with SMS API

Learn how to integrate our SMS API into your applications.

Base URL

All API requests should be made to the following base URL:

https://sms.747sandbox.com/api/v1

Authentication

To authenticate your API requests, you need to include your API token in the Authorization header of your requests.

Authorization: Bearer YOUR_ACCESS_TOKEN

You can obtain an API token by making a request to the /api/v1/auth/token endpoint with your API key and secret.

Sending Your First SMS

Let's make a simple request to send an SMS message:

curl -X POST "https://sms.747sandbox.com/api/v1/Message/custom" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": "+15551234567",
    "message": "Hello, this is a test message!"
  }'

Response Format

All API responses are returned in JSON format. A typical response will include:

  • The requested data (e.g., message details, account information)
  • Status information (e.g., message delivery status)
  • Error details (when something goes wrong)
  • Pagination information (when applicable)

Rate Limiting

Our SMS API implements rate limiting to ensure fair usage and prevent abuse. The current limits are:

  • 100 requests per minute for standard tier users
  • 500 requests per minute for premium tier users

If you exceed these limits, you'll receive a 429 Too Many Requests response with information about when you can retry.

Next Steps

Now that you understand the basics, you can: