Skip to main content
GET
/
v1
/
subscriptions
/
{id}
/
spans
Python (ticksupply library)
# pip install ticksupply
from ticksupply import Client

client = Client(api_key="<api-key>")
spans = client.subscriptions.list_spans("sub_019478a23c5f7b8e9d12abcdef012345")
print(spans)

[
  {
    "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)

Pattern: ^sub_[a-f0-9]{32}$

Response

List of subscription spans

​
id
string
required

Prefixed span ID (e.g., spn_0194a1b2c3d4e5f6a7b8c9d0e1f2a3b4)

Pattern: ^spn_[a-f0-9]{32}$
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)

Last modified on February 6, 2026