API Documentation
Integrate our powerful communication services directly into your applications.
Getting Started
Endpoints
Introduction
The smacartesim API allows you to programmatically access our services, including purchasing temporary numbers, checking account balance, and retrieving SMS messages. Our API is built around REST principles and returns JSON responses.
Authentication
Authenticate your requests by including your API key in the request headers.
Authorization: Bearer YOUR_API_KEY
You can generate and manage your API keys in your User Dashboard.
Base URL
All API requests should be made to:
https://smscartesim.com/api/v1
/user/balance
Retrieve your current account balance.
Response Example
{
"status": "success",
"balance": 50.00,
"currency": "USD"
}
/services
Get a list of available services and countries for temporary numbers.
Parameters
| Parameter | Type | Description |
|---|---|---|
| country | string | Optional. Filter by country code (e.g., 'us', 'uk'). |
/orders
Purchase a new temporary number.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| service | string | Yes | Service code (e.g., 'wa' for WhatsApp). |
| country | string | Yes | Country ID or code. |
/sms
Get SMS messages for your numbers. If no ID is provided, returns a list of active numbers.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| id | string | No | The ID of the number/order to check SMS for. |