<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "CloudKitJS",
  "identifier" : "/documentation/CloudKitJS/CloudKit.Database/fetchSubscriptions",
  "metadataVersion" : "0.1.0",
  "role" : "Instance Method",
  "symbol" : {
    "kind" : "Instance Method",
    "modules" : [
      "CloudKit JS"
    ],
    "preciseIdentifier" : "instm/CloudKit.Database/fetchSubscriptions"
  },
  "title" : "fetchSubscriptions"
}
-->

# fetchSubscriptions

Fetches one or more subscriptions.

```
Promise<CloudKit.SubscriptionsResponse, CloudKit.CKError> fetchSubscriptions(
	CloudKit.Subscription|CloudKit.Subscription[]|String|String[] subscriptions
);
```

## Parameters

`subscriptions`

Possible values are:
    
    |Type                                                                         |Description                                   |
    |-----------------------------------------------------------------------------|----------------------------------------------|
    |``doc://com.apple.cloudkitjs/documentation/CloudKitJS/CloudKit.Subscription``|A subscription in the database to fetch.      |
    |`CloudKit.Subscription[]`                                                    |An array of subscriptions to fetch.           |
    |`String`                                                                     |The ID of a subscription to fetch.            |
    |`String[]`                                                                   |An array of IDs of the subscriptions to fetch.|

## Return Value

A `Promise` object that resolves to a [`CloudKit.SubscriptionsResponse`](/documentation/CloudKitJS/CloudKit.SubscriptionsResponse) object, or rejects to a [`CKError`](/documentation/CloudKitJS/CloudKit/CKError) object.

## Discussion

See [Fetching Subscriptions by Identifier (subscriptions/lookup)](https://developer.apple.com/library/archive/documentation/DataManagement/Conceptual/CloudKitWebServicesReference/LookupSubscriptionsbyID.html#//apple_ref/doc/uid/TP40015240-CH17) in [CloudKit Web Services Reference](https://developer.apple.com/library/archive/documentation/DataManagement/Conceptual/CloudKitWebServicesReference/index.html#//apple_ref/doc/uid/TP40015240).

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)