---
schema_version: "1"
id: 29b1db75f19cb1f7d50010e78090167c6e4051fdd59c6ecb1539fb8a62d2853a
title: POST /sms/v1/contacts/subscriptions
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/contactsSubscriptions.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_sms/contactsSubscriptions.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: 2558c374b9736ac3827306feaf62307693cdc2687cb69a6ecae60bd17cf135c0
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# POST /sms/v1/contacts/subscriptions

## Overview

Returns subscription status for a mobile number or subscriber key.

### JSON Parameters

<!--complex table-->

| Name              | Type  |     | Description                                                                                   |
| ----------------- | ----- | --- | --------------------------------------------------------------------------------------------- |
| **mobileNumber**  | array |     | An array of mobile numbers. You can send up to 500 mobile numbers in a single request.         |
| **subscriberKey** | array |     | An array of subscriber keys. You can send up to 500 subscriber keys in a single request.       |

### Usage

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](http://www.iso.org/iso/country_codes/iso-3166-1_decoding_table.md "http://www.iso.org/iso/country_codes/iso-3166-1_decoding_table.htm").

**Example Request**

```js
Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com
POST /sms/v1/contacts/subscriptions
Content-Type: application/json
Authorization: Bearer YOUR_ACCESS_TOKEN

{
  "mobileNumber": ["15555555555"]
}
```

**Example Response**

```js
{
  "count": "1",
  "createDate": "2014-01-06T00:24:21.8577113Z",
  "completeDate": "2014-01-06T00:24:21.8637119Z",
  "contacts": [
    {
      "mobileNumber": "15555555555",
      "shortCode": "55555",
      "keyword": "SINGLE_OPTIN",
      "optInDate": "2013-12-30T14:10:32.2330000"
    }
  ]
}
```