Glanced
Glanced

List subscriptions

Get user's subscriptions with optional folder filtering and pagination.

GET
/v1/subscriptions
AuthorizationBearer <token>

API key (glanced_live_…). Required on operations marked with this scheme; rejected elsewhere.

In: header

Query Parameters

limit?Limit

Number of subscriptions to return

Range1 <= value <= 100
Default50
offset?Offset

Number of subscriptions to skip (used for alphabetical ordering)

Range0 <= value
Default0
folder_id?|

Filter subscriptions by folder ID. If not provided, returns subscriptions without folder assignment (unless all=True)

all?All

Return all subscriptions regardless of folder assignment. When true, folder_id is ignored

Defaultfalse
order_by?|

Order subscriptions: 'name' for alphabetical A-Z with offset pagination, 'recent' for cursor-based pagination (newest items first)

cursor?|

Pagination cursor for fetching next page when order_by='recent'

source_type?|

Filter by source type: 'feed', 'newsletter', or 'podcast'

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/subscriptions"
{  "data": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "source_type": "feed",      "title": "string",      "unread_count": 0,      "status": "healthy",      "website": "string",      "is_pinned": false,      "is_active": true,      "newsletter_address": "string",      "podcast_id": "4c1cb0f8-818b-4f7a-9ddb-0d1ea990b35a",      "artist": "string",      "playback_speed": 0    }  ],  "pagination": {    "total": 0,    "limit": 0,    "offset": 0,    "has_more": true,    "next_cursor": "string"  }}

How is this guide?