BixelDocs
API reference

Get one watch subscription

GET
/v1/watch/subscriptions/{id}

One subscription with its dimension filter, endpoint routing, and watched-company count. Pass include_companies=1 for the full watched domain list. Another account's subscription answers the same 404 as a nonexistent one. Costs 0 credits.

Authorization

AuthorizationBearer <token>

bx_-prefixed API key. Free keys: https://bixel.com/account/

In: header

Path Parameters

id*string

Query Parameters

include_companies?string

Present = include the watched domain list.

Response Body

application/json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/watch/subscriptions/string"
{  "data": {    "subscription": {      "id": "string",      "name": "string",      "dimensions": [        "string"      ],      "active": true,      "companies_count": 0,      "endpoint_ids": [        "string"      ],      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z"    },    "companies": [      "string"    ]  },  "meta": {    "generated_at": "2019-08-24T14:15:22Z",    "count": 0,    "total": 0,    "next_cursor": "string",    "notice": "string",    "window": {      "served_from": "string",      "earliest_event_at": "string",      "events_beyond_window": true    }  }}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}
{  "type": "http://example.com",  "title": "string",  "status": 0,  "code": "company_not_found",  "detail": "string",  "hint": "string",  "docs_url": "http://example.com"}