Skip to main content
GET
/
v1
/
subscriptions
/
{id}
/
spans
Get subscription spans
curl --request GET \
  --url https://api.ticksupply.com/v1/subscriptions/{id}/spans \
  --header 'X-Api-Key: <api-key>'
[
  {
    "id": "spn_0194a1b2c3d4e5f6a7b8c9d0e1f2a3b4",
    "started_at": "2024-01-15T10:00:00Z",
    "ended_at": "2024-01-20T18:30:00Z"
  },
  {
    "id": "spn_0194b2c3d4e5f6a7b8c9d0e1f2a3b4c5",
    "started_at": "2024-01-25T09:00:00Z",
    "ended_at": "2024-02-01T12:00:00Z"
  },
  {
    "id": "spn_0194c3d4e5f6a7b8c9d0e1f2a3b4c5d6",
    "started_at": "2024-02-05T08:00:00Z",
    "ended_at": null
  }
]

Authorizations

​
X-Api-Key
string
header
required

Your API key. Get one from the dashboard at https://app.ticksupply.com/api-keys

Path Parameters

​
id
string
required

Subscription ID (prefixed format, e.g., sub_xxx)

Response

List of subscription spans

​
id
string
required

Prefixed span ID (e.g., spn_0194a1b2c3d4e5f6a7b8c9d0e1f2a3b4)

Example:

"spn_0194a1b2c3d4e5f6a7b8c9d0e1f2a3b4"

​
started_at
string<date-time>
required

When data collection started

​
ended_at
string<date-time> | null

When data collection ended (null if ongoing)