> ## Documentation Index > Fetch the complete documentation index at: https://docs.ticksupply.com/llms.txt > Use this file to discover all available pages before exploring further. # Get subscription spans > Returns the time spans during which data was collected for this subscription. Spans are created when a subscription is activated/resumed and ended when paused/deleted. ## OpenAPI ````yaml get /v1/subscriptions/{id}/spans openapi: 3.1.0 info: title: Ticksupply API version: 1.0.0 description: > The Ticksupply API provides programmatic access to cryptocurrency market data. Subscribe to real-time data streams, manage subscriptions, and export historical data. contact: name: Ticksupply Support email: support@ticksupply.com termsOfService: https://ticksupply.com/terms license: name: Proprietary url: https://ticksupply.com/terms servers: - url: https://api.ticksupply.com description: Production API security: - ApiKeyAuth: [] tags: - name: Catalog description: Browse available exchanges, instruments, and data streams - name: Subscriptions description: Manage data stream subscriptions - name: Exports description: Export historical data to downloadable files - name: Availability description: Query data availability for specific streams - name: Export Schemas description: Manage export column schemas for customized CSV output - name: Billing description: Inspect your plan, access status, and usage for the current billing period paths: /v1/subscriptions/{id}/spans: get: tags: - Subscriptions summary: Get subscription spans description: > Returns the time spans during which data was collected for this subscription. Spans are created when a subscription is activated/resumed and ended when paused/deleted. operationId: getSubscriptionSpans parameters: - name: id in: path required: true description: Subscription ID (prefixed format, e.g., sub_xxx) schema: type: string pattern: ^sub_[a-f0-9]{32}$ example: sub_550e8400e29b41d4a716446655440000 responses: '200': description: List of subscription spans content: application/json: schema: type: array items: $ref: '#/components/schemas/SubscriptionSpan' example: - 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 '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '408': $ref: '#/components/responses/RequestTimeout' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' x-codeSamples: - lang: python label: Python (ticksupply library) source: > # pip install ticksupply from ticksupply import Client client = Client(api_key="") spans = client.subscriptions.list_spans("sub_019478a23c5f7b8e9d12abcdef012345") print(spans) - lang: rust label: Rust (ticksupply crate) source: | // cargo add ticksupply // cargo add tokio --features full use ticksupply::Client; #[tokio::main] async fn main() -> ticksupply::Result<()> { let client = Client::with_api_key("")?; let spans = client.subscriptions() .list_spans("sub_019478a23c5f7b8e9d12abcdef012345") .await?; println!("{spans:#?}"); Ok(()) } components: schemas: SubscriptionSpan: type: object required: - id - started_at properties: id: type: string pattern: ^spn_[a-f0-9]{32}$ description: Prefixed span ID (e.g., spn_0194a1b2c3d4e5f6a7b8c9d0e1f2a3b4) example: spn_0194a1b2c3d4e5f6a7b8c9d0e1f2a3b4 started_at: type: string format: date-time description: When data collection started ended_at: type: string format: date-time nullable: true description: When data collection ended (null if ongoing) ApiError: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string description: Error code for programmatic handling enum: - invalid_argument - unauthenticated - permission_denied - not_found - already_exists - request_timeout - rate_limited - payment_required - internal - unavailable message: type: string description: Human-readable error message details: type: object description: Additional error details (optional) responses: Unauthorized: description: Missing or invalid API key headers: X-Request-Id: description: Unique request identifier for support inquiries schema: type: string example: req_abc123def456 content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: code: unauthenticated message: Invalid or missing API key NotFound: description: Resource not found headers: X-Request-Id: description: Unique request identifier for support inquiries schema: type: string example: req_abc123def456 content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: code: not_found message: Subscription not found RequestTimeout: description: | Request did not complete within the 10-second deadline. Retry with exponential backoff. If you see this consistently on a particular endpoint, contact support. headers: X-Request-Id: description: Unique request identifier for support inquiries schema: type: string example: req_abc123def456 content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: code: request_timeout message: Request exceeded 10s deadline RateLimited: description: Rate limit exceeded headers: X-Request-Id: description: Unique request identifier for support inquiries schema: type: string example: req_abc123def456 Retry-After: description: Seconds to wait before retrying schema: type: integer X-RateLimit-Limit-Minute: description: Maximum requests allowed per minute schema: type: integer X-RateLimit-Remaining-Minute: description: Requests remaining in the current minute window schema: type: integer X-RateLimit-Reset-Minute: description: >- Unix timestamp (seconds) when the minute window next has capacity. Included only when the minute bucket is exhausted. schema: type: integer X-RateLimit-Limit-Hour: description: Maximum requests allowed per hour schema: type: integer X-RateLimit-Remaining-Hour: description: Requests remaining in the current hour window schema: type: integer X-RateLimit-Reset-Hour: description: >- Unix timestamp (seconds) when the hour window next has capacity. Included only when the hour bucket is exhausted. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: code: rate_limited message: Rate limit exceeded. Retry after 30 seconds. InternalError: description: Internal server error headers: X-Request-Id: description: Unique request identifier for support inquiries schema: type: string example: req_abc123def456 content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: code: internal message: An internal error occurred securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-Api-Key description: >- Your API key. Get one from the dashboard at https://app.ticksupply.com/api-keys ````