API

Guides

Messages

Voice

WhatsApp Business

Groups

Contacts

Outbox

Account

Sender IDs

Teammate/Subaccount

Conversations

Workflows

Message Templates

Birthday Message

Opt-out

Other

Webhooks (v2)

Get inbound message

Get a single received (inbound) message. Both the numeric ID and the public ID (inb_...) from Get inbox are accepted.

Base URL:

GET: https://api.smsgatewayapi.com/v1/message/inbound/{ID}

Example:

GET: https://api.smsgatewayapi.com/v1/message/inbound/115113
ParameterInputDescription
client_idAPI client IDDeveloper › API & Webhooks › API credentials
Required
client_secretAPI client secretA cs_ credential, shown once when you create it under Developer › API & Webhooks › API credentials
Required
IDinbound message IDThe ID of the inbound message. Both the numeric ID and the public ID (inb_...) are accepted
Required
<?php
	//PHP - cURL
	$ch = curl_init();
	$url = "https://api.smsgatewayapi.com/v1/message/inbound/{ID}";
	$client_id = "XXX"; // Your API client ID (required)
	$client_secret = "YYY"; // Your API client secret (required)
	
curl_setopt($ch, CURLOPT_URL, "$url"); curl_setopt($ch, CURLOPT_POST, false); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET'); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_VERBOSE, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-Client-Id: $client_id", "X-Client-Secret: $client_secret", "Content-Type: application/json", ]); $response = curl_exec($ch); ?>

Example success response:

{
	"message": {
		"ID": "{ID}",
		"public_ID": "inb_46f4c0e37652d4149352e1cb54fed50b",
		"message": "Hello sms",
		"sender": "{nr}",
		"type": "sms",
		"date": "2026-08-01 12:00:00",
		"receiver": "{inbox_nr}",
		"orig_message": {
			"ID": "",
			"public_ID": null,
			"message": null,
			"date": null
		},
		"file": null
	}
}

If the inbound message is a reply to a message you sent, orig_message contains the original outbound message.

Invalid response:

Response when the ID doesn’t exist: http status code 404 (Not Found).

SMS API

Smstools
Integrate our SMS Gateway by implementing our SMS API, and add text messaging to your platform in minutes. Free trial. SMS API
5 out of 5 based on 3302 user ratings.
SMSGATEWAYAPI API1

REGISTER NOW

Discover our SMS platform today!

REGISTER