<- Subscriptions API

Subscriptions API

Search subscriptions

POST

 /v2/subscriptions/search

Searches for subscriptions.

Results are ordered chronologically by subscription creation date. If the request specifies more than one location ID, the endpoint orders the result by location ID, and then by creation date within each location. If no locations are given in the query, all locations are searched.

You can also optionally specify customer_ids to search by customer. If left unset, all customers associated with the specified locations are returned. If the request specifies customer IDs, the endpoint orders results first by location, within location by customer ID, and within customer by subscription creation date.

For more information, see Retrieve subscriptions.

Permissions:SUBSCRIPTIONS_READ

Guide

Subscriptions Guide

Try in API Explorer
Link to section

Request body

Example code

Link to section

cursor

string

When the total number of resulting subscriptions exceeds the limit of a paged response, specify the cursor returned from a preceding response here to fetch the next set of results. If the cursor is unset, the response contains the last page of the results.

For more information, see Pagination.

Link to section

limit

integer(32-bit)

The upper limit on the number of subscriptions to return in a paged response.

Min
1
Link to section

query

A subscription query consisting of specified filtering conditions.

If this query field is unspecified, the SearchSubscriptions call will return all subscriptions.

Show attributes
Link to section

include

string [ ]

Beta

An option to include related information in the response.

The supported values are:

  • actions: to include scheduled actions on the targeted subscriptions.
Link to section

Response fields

Link to section

errors

Errors encountered during the request.

Show attributes
Link to section

subscriptions

The subscriptions matching the specified query expressions.

Show attributes
Link to section

cursor

string

When the total number of resulting subscription exceeds the limit of a paged response, the response includes a cursor for you to use in a subsequent request to fetch the next set of results. If the cursor is unset, the response contains the last page of the results.

For more information, see Pagination.

Error descriptions