List Subscriptions

Request

Filters and returns Subscriptions with basic info for existing Subscriber.

Security

ApiKeyAuth

Path

subdomainstringrequired

Unique subdomain of requested Hub.

subscriber_idintegerrequired

id of the subscriber

Query

deletedstring

Filters subscriptions by deletion status:

true - return only subscriptions that were deleted,
false - return only subscriptions that were not deleted,
all - return subscriptions without filtering by deleted status.

Default:"false"

Enum:"true""false""all"

deleted_afterstring, (date-time)

Filters Subscriptions by the timestamp of record deletion.
Looks for Subscriptions deleted on or after the deleted_after timestamp.
ISO8601 formatted time (UTC).

Example:deleted_after=2020-09-01T08:29:00Z

qstring

String that filters subscriptions to those containing the search string in:

address,
label.

extendstring

Specifies which properties should be expanded.
Expanded properties contains more detailed information which is less frequently needed in typical usage.
Currently supported only for flags.

Example:extend=flags

sort_propstring

Determines which property results should be sorted by.

Default:"created_at"

Enum:"created_at""updated_at"

sort_dirstring

Determines sorting direction.

Default:"desc"

Enum:"asc""desc"

pageinteger, >= 1

Requested page index.

Default:1

per_pageinteger, [ 1 .. 100 ]

A limit on the number of records to be returned.

Default:25

api_versionstring

Api version

Value:"V3-R1"

curl -i -X GET \
  'https://subdomain-of-your-account.app.statushub.io/api/v3/hubs/{subdomain}/subscribers/{subscriber_id}/subscriptions?deleted=true&deleted_after=2020-09-01T08%3A29%3A00Z&q=string&extend=flags&sort_prop=created_at&sort_dir=asc&page=1&per_page=25&api_version=V3-R1' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json

current_pageinteger, >= 1

Example:1

page_countinteger, >= 1

Example:4

per_pageinteger, [ 1 .. 100 ]

Example:25

totalinteger, >= 0

Example:1024

dataArray of objects, <= 100 items

Response

{
  "current_page": 1,
  "page_count": 4,
  "per_page": 25,
  "total": 1024,
  "data": [
    { … }
  ]
}