# Cognite Data point subscriptions API

**Canonical:** https://apis.io/apis/cognite/cognite-data-point-subscriptions-api/  
**Provider:** Cognite — https://apis.io/providers/cognite/  
**Base URL:** https://api.cognitedata.com  
**Documentation:** https://api-docs.cognite.com/

Cognite Data point subscriptions API is one of 90 APIs that [Cognite](https://apis.io/providers/cognite/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Data point subscriptions. The published artifact set on APIs.io includes an OpenAPI specification.

A data point subscription is a way to listen to changes to time series data points, in ingestion order. A single subscription can listen to many time series, and a time series can be part of many subscriptions. You listen to subscriptions by calling the “list subscription data“ endpoint. It will return a list of data point upserts and deleted ranges, together with a cursor to retrieve the next batch of updates. Updates written since the creation of the subscription, up to 7 days ago, can be retrieved through the subscription. Subscriptions can be defined explicitly through a list of time series external ids and instance ids, or implicitly through a filter. The filter is a subset of the advanced filter query in the regular “time series search“ endpoint. Partitions: Subscriptions can be further divided into a number of partitions, for the purpose of fetching subscription data in parallel. Each partition will return data in ingestion order, but the order between partitions is not guaranteed. Limitations: - Each subscription can have at most 10000 time series. - A time series can be part of at most 10 subscriptions. - A project can have at most 1000 subscriptions, of which 100 are filter subscriptions. - Time series with security categories can not be shown in filter subscriptions. - Time series with neither external id nor instance id cannot be added to non-filter subscriptions. - The number of partitions cannot be changed after creation. Access control: You need READ access to subscriptions ACL to read/list subscriptions or list data, and you need WRITE access to create/update/delete subscriptions. Furthermore, you need READ access to the time series you want to get updates from. For filter subscriptions, you either need READ access to all time series, or the filter must be restricted according to your access rights (e.g. by filtering on specific data set IDs). Subscriptions can have data sets that allow for more granular access control. The data set on a subscription does not influence the data stream, but allows you to restrict who can read/update the subscription. Name of ACL: `timeSeriesSubscriptionsAcl` Supported actions: - `READ` - `WRITE` Example capabilities: ``` [ {"timeSeriesAcl":{"actions":["READ"], "scope":{"all":{}}}}, {"timeSeriesSubscriptionsAcl":{"actions":["WRITE", "READ"], "scope":{"all":{}}}} ] ```

## Machine-readable artifacts (1)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/cognite/refs/heads/main/openapi/cognite-data-point-subscriptions-api-openapi.yml

## Other Cognite APIs (12)

- [Cognite Data Fusion API](https://apis.io/apis/cognite/cognite-data-fusion-api/)
- [Cognite 3D Asset Mapping API](https://apis.io/apis/cognite/cognite-3d-asset-mapping-api/)
- [Cognite 3D Files API](https://apis.io/apis/cognite/cognite-3d-files-api/)
- [Cognite 3D Jobs API](https://apis.io/apis/cognite/cognite-3d-jobs-api/)
- [Cognite 3D Model Revisions API](https://apis.io/apis/cognite/cognite-3d-model-revisions-api/)
- [Cognite 3D Models API](https://apis.io/apis/cognite/cognite-3d-models-api/)
- [Cognite Annotations API](https://apis.io/apis/cognite/cognite-annotations-api/)
- [Cognite Assets API](https://apis.io/apis/cognite/cognite-assets-api/)
- [Cognite Connections API](https://apis.io/apis/cognite/cognite-connections-api/)
- [Cognite Containers API](https://apis.io/apis/cognite/cognite-containers-api/)
- [Cognite Data models API](https://apis.io/apis/cognite/cognite-data-models-api/)
- [Cognite Data products API](https://apis.io/apis/cognite/cognite-data-products-api/)

## Tags

Data point subscriptions

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/cognite/cognite-data-point-subscriptions-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/cognite/.