Coupontools Logo

API & Webhooks

Connect the Coupontools platform with your apps or web projects. The Coupontools REST API allows you to query meta-data about your account, campaigns, distribution, validations, and usage data.

Retrieve a list of the SMS subscribers from a group

Returns a list of all the subscribers to a specific SMS group.
Base URL
# Parameter Input Description
1 client_id API client ID Can be found in your API documentation
2 client_secret API client secret Can be found in your API documentation
3 smsgroup ID of the SMS group Can be found in the SMS Group list API endpoint.
	$ch = curl_init();
	$url = "";
	$client_id = "XXX"; // Your API client ID (required)
	$client_secret = "YYY"; // Your API client secret (required)
	$data = [
	curl_setopt($ch, CURLOPT_URL, "$url");
	curl_setopt($ch, CURLOPT_POST, true);
	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",
	curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
	$response = curl_exec($ch);
Example response
			"status": {
				"status": "OK"
			"group_id": "gro_123456",
			"group_name": "Subscribers to keyword pizza",
			"amount_of_contacts": "2",
			"contact": [
					"ID": "con_123456",
					"phone": "123456789012",
					"first_name": "John",
					"last_name": "Doe",
					"unsubscribed": "1",
					"unsubscribedate": "13/07/2018 19:47 UTC"
					"ID": "con_1234567",
					"phone": "441234567890",
					"first_name": "Jeff",
					"last_name": "Jefferson",
					"unsubscribed": "0"
Possible errors
  • 103: Your account is not connected with the Coupontools SMS services
  • 200: Missing parameter: smsgroup
  • 301: Invalid character in parameter: smsgroup.
  • 514: Group ID not found in your account!

  • Inscrivez-vous pour un compte d'essai de 7 jours

    Commencez à utiliser Coupontools dès aujourd'hui !

C'est bien que vous soyez ici ! Des cookies ? Lisez notre déclaration de confidentialité. J'accepte