POST /sms/v1/contacts/subscriptions

Returns subscription status for a mobile number or subscriber key.

The phone number must use the correct format for the designated country code. For example, a mobile number from the United States must include the numerical country code 1 and the applicable area code as displayed in the sample CSV file. Note that the numerical country code mentioned here applies only to the phone number itself, and that any separate field containing country code information must conform to ISO-3306-1 alpha-2 standards.

Example Request

1Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
2POST /sms/v1/contacts/subscriptions
3Content-Type: application/json
4Authorization: Bearer YOUR_ACCESS_TOKEN
5
6{
7  "mobileNumber": ["15555555555"]
8}

Example Response

1{
2  "count": "1",
3  "createDate": "2014-01-06T00:24:21.8577113Z",
4  "completeDate": "2014-01-06T00:24:21.8637119Z",
5  "contacts": [
6    {
7      "mobileNumber": "15555555555",
8      "shortCode": "55555",
9      "keyword": "SINGLE_OPTIN",
10      "optInDate": "2013-12-30T14:10:32.2330000"
11    }
12  ]
13}