v1
latestOpenAPI 3.0.32026-08-0623677345.2 KBBilling
List subscriptions
get/subscriptions/
Query parameters
pageinteger
Page number to retrieve (1-indexed).
page_sizeinteger
Number of items per page.
orderingstring
Field to sort results by. Prefix with - for descending order (e.g. -created).
customerstring
status'active' | 'paused' | 'cancelled' | 'finalized' | 'needs_attention'
next_billingstring date
date_startstring date
documentinteger
linesstring
Filter by linked line ID.
addonsinteger
couponstring
cancelledstring date-time
cancel_reasonstring
pausedstring date-time
paused_reasonstring
needs_attentionstring date-time
needs_attention_reasonstring
instantboolean
Compute on-the-fly billing for the response.
Headers
x-simple-workspacestring required
Workspace (account) identifier. Required for every request.
x-piriod-test-modeboolean
Whether to operate against test-mode data. Defaults to false.
Response
Paginated subscription list.
Example response
{
"count": 142
}