Call Logs API Documentation

Bắt đầu từ đây

Your first request in four steps

Connect a phone and enable call synchronization.

Copy the API key from the dashboard.

Call the missed or incoming list endpoint.

Paginate with limit and offset and store timestamps in UTC.

The secure SMSMobileAPI mobile app connecting a phone to the web dashboard and REST API for SMS and call operations — Encrypted mobile-to-platform connection

Official mobile application

The secure bridge between your phone, dashboard and API.

SMS and call operations pass through the official SMSMobileAPI app installed on your connected phone. The app securely pairs the device with your account, synchronizes authorized events and links the mobile network to the dashboard and REST API.

1Mobile appPairs the phone and its SIM 2Encrypted linkAuthenticates and protects data in transit 3Dashboard & APIControls workflows and activity

Signed releases distributed through the official Google Play and Apple App Store listings
Google and Apple platform review, signing and distribution controls
Secure device pairing, HTTPS transport and authenticated API access
Only the permissions required for the mobile features you enable

Get the official SMSMobileAPI app on Google Play

Download the official SMSMobileAPI app on the Apple App Store

Capabilities depend on the permissions and background access allowed by Android or iOS.

Xác thực

Keep credentials on your server

Call endpoints use the apikey query parameter. The API validates both the key and the active subscription before returning call activity.

Before you integrate

Background operating-system restrictions can delay mobile call synchronization by several minutes. Open the app to request a manual synchronization when testing.

LẤY

List missed calls

ENDPOINThttps://api.smsmobileapi.com/call/missed/list/

Returns missed calls from newest to oldest.

When to use it

Use it to trigger callback workflows and missed-call alerts.

Các tham số

Tên	Kiểu	Requirement	Sự miêu tả
`apikey`	sợi dây	Yêu cầu	Khóa API của bạn.
`offset`	integer	Không bắt buộc	Pagination offset; default 0.
`limit`	integer	Không bắt buộc	Rows per request; default 100, maximum 500.
`search`	sợi dây	Không bắt buộc	Search caller number or cached name.
`date_start`	YYYY-MM-DD	Không bắt buộc	Include calls from 00:00:00 on this day.
`date_end`	YYYY-MM-DD	Không bắt buộc	Include calls until 23:59:59 on this day.

Request example

cURL

curl "https://api.smsmobileapi.com/call/missed/list/?apikey=YOUR_API_KEY&offset=0&limit=100"

Ví dụ về câu trả lời

JSON

{
  "success": true,
  "offset": 0,
  "limit": 100,
  "count": 1,
  "data": [{"number": "+15551230001", "name": "Alex Carter", "date": "2026-03-20 16:12:28"}]
}

Want to run this request? Connect your API key at the top of the page to unlock the interactive tester.

Connect key ↑

LẤY

List incoming answered calls

ENDPOINThttps://api.smsmobileapi.com/call/incoming/list/

Returns answered incoming calls with duration, timestamps and cached contact details.

When to use it

Use it for call reporting, CRM history and customer-service metrics.

Các tham số

Tên	Kiểu	Requirement	Sự miêu tả
`apikey`	sợi dây	Yêu cầu	Khóa API của bạn.
`limit`	integer	Không bắt buộc	Default 50, maximum 200.
`offset`	integer	Không bắt buộc	Pagination offset.
`sort_by`	enum	Không bắt buộc	call_date_ms, call_datetime_utc, duration_sec, phone_number, created_at, cached_name or geo_location.
`sort_dir`	asc \| desc	Không bắt buộc	Default desc.
`date_from_ms`	Unix milliseconds	Không bắt buộc	Minimum call timestamp.
`date_to_ms`	Unix milliseconds	Không bắt buộc	Maximum call timestamp.
`q`	sợi dây	Không bắt buộc	Search phone number or cached name.

Request example

cURL

curl "https://api.smsmobileapi.com/call/incoming/list/?apikey=YOUR_API_KEY&limit=50&sort_by=call_date_ms&sort_dir=desc"

Ví dụ về câu trả lời

JSON

{
  "success": true,
  "count": 1,
  "rows": [{
    "phone_number": "+15551230010",
    "cached_name": "Jordan Blake",
    "call_date_ms": 1774027779390,
    "call_datetime_utc": "2026-03-20 17:29:39",
    "duration_sec": 23,
    "geo_location": "Canada"
  }]
}

Want to run this request? Connect your API key at the top of the page to unlock the interactive tester.

Connect key ↑

LẤY

List outgoing calls

ENDPOINThttps://api.smsmobileapi.com/call/outgoing/list/

Returns calls placed from connected devices.

When to use it

Use it to complete call timelines and analyze outbound activity.

Các tham số

Tên	Kiểu	Requirement	Sự miêu tả
`apikey`	sợi dây	Yêu cầu	Khóa API của bạn.
`limit`	integer	Không bắt buộc	Default 50, maximum 200.
`offset`	integer	Không bắt buộc	Pagination offset.
`sort_by`	enum	Không bắt buộc	call_date_ms, call_datetime_utc, duration_sec, phone_number, created_at, cached_name or geo_location.
`sort_dir`	asc \| desc	Không bắt buộc	Default desc.
`date_from_ms`	Unix milliseconds	Không bắt buộc	Minimum call timestamp.
`date_to_ms`	Unix milliseconds	Không bắt buộc	Maximum call timestamp.
`q`	sợi dây	Không bắt buộc	Search phone number or cached name.

Request example

cURL

curl "https://api.smsmobileapi.com/call/outgoing/list/?apikey=YOUR_API_KEY&limit=50&offset=0&sort_by=call_date_ms&sort_dir=desc"

Ví dụ về câu trả lời

JSON

{
  "success": true,
  "count": 1,
  "rows": [{
    "phone_number": "+15551230020",
    "cached_name": "Casey Morgan",
    "call_date_ms": 1774025965645,
    "call_datetime_utc": "2026-03-20 16:59:25",
    "duration_sec": 61,
    "geo_location": "Canada"
  }]
}

Want to run this request? Connect your API key at the top of the page to unlock the interactive tester.

Connect key ↑

Xử lý sự cố

Errors and safe retries

Read the HTTP status and the JSON error field before retrying. Do not retry validation or authentication failures without correcting the request first.

HTTP	Bộ mã	What to do
400	`missing_apikey`	The apikey parameter is missing or empty.
403	`invalid_apikey`	The key is not recognized.
403	`api_expired`	The subscription linked to the key has expired.
500	`server_error`	The request could not be completed by the call service.

Retry ruleRetry only transient 429 and 5xx responses. Start after 1 second, then back off to 2, 4 and 8 seconds.

Bạn cần trợ giúp?

Bring the request context—not your secrets.

Share the endpoint, timestamp, HTTP status and sanitized response. Never include API keys, tokens or private message content.

Contact API support →

Call API documentation

Your first request in four steps

The secure bridge between your phone, dashboard and API.

Keep credentials on your server

Các tham số

Request example

Ví dụ về câu trả lời

Các tham số

Request example

Ví dụ về câu trả lời

Các tham số

Request example

Ví dụ về câu trả lời

Errors and safe retries

Bring the request context—not your secrets.