Facebookpixel Doc Dev Call - SMSMobileAPI
SMSMobileAPI – Call Management API Documentation

Call Management API Documentation

These endpoints let you retrieve your Missed Calls, Incoming Answered Calls, and Outgoing Calls synced from the SMSMobileAPI mobile app into your dashboard + API.

Important: if the mobile app runs in the background, the phone system may impose a delay (often up to ~10 minutes) between synchronizations. You can always open the app to sync manually if needed.

Need help? api@smsmobileapi.com

Quickstart

Base URL

GET https://api.smsmobileapi.com
All endpoints below are documented as GET requests. Replace YOUR_API_KEY with your real key (do not share it publicly).

Examples

GET https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY
GET https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc
GET https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&q=%2B3247&date_from_ms=1700000000000&date_to_ms=1700864000000

Authentication

Call Management endpoints authenticate using the apikey query parameter.

Subscription validation: Incoming/Outgoing endpoints validate your API key and check your subscription validity (dateLimit >= CURDATE()). If expired, you’ll receive api_expired.

Common concepts

Pagination

Use limit and offset to paginate results.

Timestamps

  • call_date_ms is a UNIX timestamp in milliseconds.
  • call_datetime_utc is stored as a UTC datetime string (database field).
  • For Missed Calls, the API returns a formatted date string (derived from a milliseconds value).

Search

  • Missed calls: search matches number or name.
  • Incoming/Outgoing: q matches phone_number or cached_name.

Sorting (Incoming/Outgoing only)

Sorting is controlled by sort_by + sort_dir (whitelisted fields only). Missed calls are always ordered by newest first.

Errors

HTTP Example error Meaning
400 {"success":false,"error":"missing_apikey"} Missing or empty apikey.
403 {"success":false,"error":"invalid_apikey"} API key not found / not recognized.
403 {"success":false,"error":"api_expired"} Your subscription is expired (dateLimit is before today).
500 {"success":false,"error":"server_error","detail":"..."} Server error (database, SQL, exception).

Note: the Missed Calls endpoint can also return messages like Missing apikey or SQL preparation errors depending on the situation.

Missed Calls – List

Retrieve missed calls synchronized from the mobile device.

Endpoint

GET https://api.smsmobileapi.com/call/missed/list/

Query parameters

ParameterTypeDescription
apikeystringRequired Your API key linked to the mobile phone.
offsetintOptional Pagination offset (default: 0).
limitintOptional Max rows (default: 100, max: 500).
searchstringOptional Search by number or name (SQL LIKE).
date_startYYYY-MM-DDOptional Filter from this day (00:00:00).
date_endYYYY-MM-DDOptional Filter up to this day (23:59:59).

Incoming Calls – List

Retrieve incoming answered calls synchronized from the mobile device.

Endpoint

GET https://api.smsmobileapi.com/call/incoming/list/

Query parameters

ParameterTypeDescription
apikeystringRequired Your API key (validated against subscription).
limitintOptional Rows per page (default: 50, max: 200).
offsetintOptional Pagination offset (default: 0).
sort_bystring Optional Allowed: call_date_ms call_datetime_utc duration_sec phone_number created_at cached_name geo_location
sort_dirasc|descOptional Default: desc.
date_from_msint (ms)Optional Filter where call_date_ms >= date_from_ms.
date_to_msint (ms)Optional Filter where call_date_ms <= date_to_ms.
qstringOptional Search on phone_number or cached_name (LIKE).

Outgoing Calls – List

Retrieve outgoing calls synchronized from the mobile device.

Endpoint

GET https://api.smsmobileapi.com/call/outgoing/list/

Query parameters

Same parameters and behavior as Incoming Calls.

ParameterTypeDescription
apikeystringRequired Your API key (validated against subscription).
limitintOptional Rows per page (default: 50, max: 200).
offsetintOptional Pagination offset (default: 0).
sort_bystring Optional Allowed: call_date_ms call_datetime_utc duration_sec phone_number created_at cached_name geo_location
sort_dirasc|descOptional Default: desc.
date_from_msint (ms)Optional Filter where call_date_ms >= date_from_ms.
date_to_msint (ms)Optional Filter where call_date_ms <= date_to_ms.
qstringOptional Search on phone_number or cached_name (LIKE).

Missed call fields

FieldTypeDescription
successboolRequest status.
offsetintPagination offset returned.
limitintPagination limit returned.
countintNumber of rows returned in data.
dataarrayList of missed calls.
data[].numberstringCaller phone number.
data[].namestringCached contact name (may be empty).
data[].datestringFormatted datetime string derived from a milliseconds timestamp.

Incoming/Outgoing fields

FieldTypeDescription
successboolRequest status.
apikeystringEchoed back by API (your key).
limitintRows per page returned.
offsetintPagination offset returned.
sort_bystringApplied sort field.
sort_dirstringApplied sort direction.
filtersobjectEchoed filters (date_from_ms, date_to_ms, q).
countintNumber of rows returned in rows.
rowsarrayList of calls.
rows[].phone_numberstringPhone number.
rows[].cached_namestring|nullCached contact name (can be null).
rows[].call_date_msintCall timestamp in milliseconds.
rows[].call_datetime_utcstringUTC datetime field (database).
rows[].duration_secintDuration in seconds.
rows[].geo_locationstring|nullGeo location label (can be null/empty).
rows[].created_atstringServer insertion timestamp.
Need help? Contact api@smsmobileapi.com
Tip: never publish your API key in screenshots, tickets, or public repositories.
💬 Live Chat
💬 Live Chat Available
Have any questions or need assistance ?
Our team is here to help you!
Enter your email address
to help us follow up on your request :
Dashboard