curl --request POST \
--url https://development.knotapi.com/subscriptions/list \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"external_user_id": "abc"
}
'{
"subscriptions": [
{
"id": "13da3c28-a068-4642-9ce2-b730cfda5f5f",
"external_id": "a9x7bq2lmw5p",
"name": "Disney+, Hulu Bundle Premium",
"description": "Ad-free streaming with Disney+ and Hulu",
"merchant": {
"id": 18,
"name": "Hulu",
"category": "Streaming",
"logo": "https://knot.imgix.net/merchants/KBQ5j6cN010PPpwbO7RpKGyDrCpsZ91FRhwnZp5u.png",
"parent_merchant": null
},
"status": "ACTIVE",
"billing_cycle": "RECURRING_MONTHLY",
"next_billing_date": "2026-02-10",
"last_billing_date": "2026-01-10",
"start_date": "2025-06-15",
"expiration_date": null,
"payment_method": {
"type": "CARD",
"brand": "VISA",
"last_four": "1234"
},
"cancel_instructions": "You can cancel your subscription at any time from your account settings. Your cancellation will take effect at the end of your current billing period.",
"is_paid": true,
"is_family_plan": false,
"is_cancellable": true,
"price": {
"total": "11.99",
"currency": "USD"
}
},
{
"id": "7a2e9f14-b532-48d1-ae73-c9f2d8e61b4a",
"external_id": "sp_sub_8x2k4m",
"name": "Premium Individual",
"description": "Ad-free music streaming for one account",
"merchant": {
"id": 13,
"name": "Spotify",
"category": "Streaming",
"logo": "https://knot.imgix.net/merchants/spotify-logo.png",
"parent_merchant": null
},
"status": "ACTIVE",
"billing_cycle": "RECURRING_MONTHLY",
"next_billing_date": "2026-03-10",
"last_billing_date": "2026-02-10",
"start_date": "2024-09-01",
"expiration_date": null,
"payment_method": {
"type": "CARD",
"brand": "VISA",
"last_four": "1234"
},
"cancel_instructions": "You can cancel your subscription at any time from your account settings.",
"is_paid": true,
"is_family_plan": false,
"is_cancellable": true,
"price": {
"total": "12.99",
"currency": "USD"
}
}
],
"next_cursor": "eyJpZCI6MjI3ODEsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
"limit": 100
}SubscriptionManager
List Subscriptions
List a user’s subscriptions using cursor-based pagination.
POST
/
subscriptions
/
list
curl --request POST \
--url https://development.knotapi.com/subscriptions/list \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data '
{
"external_user_id": "abc"
}
'{
"subscriptions": [
{
"id": "13da3c28-a068-4642-9ce2-b730cfda5f5f",
"external_id": "a9x7bq2lmw5p",
"name": "Disney+, Hulu Bundle Premium",
"description": "Ad-free streaming with Disney+ and Hulu",
"merchant": {
"id": 18,
"name": "Hulu",
"category": "Streaming",
"logo": "https://knot.imgix.net/merchants/KBQ5j6cN010PPpwbO7RpKGyDrCpsZ91FRhwnZp5u.png",
"parent_merchant": null
},
"status": "ACTIVE",
"billing_cycle": "RECURRING_MONTHLY",
"next_billing_date": "2026-02-10",
"last_billing_date": "2026-01-10",
"start_date": "2025-06-15",
"expiration_date": null,
"payment_method": {
"type": "CARD",
"brand": "VISA",
"last_four": "1234"
},
"cancel_instructions": "You can cancel your subscription at any time from your account settings. Your cancellation will take effect at the end of your current billing period.",
"is_paid": true,
"is_family_plan": false,
"is_cancellable": true,
"price": {
"total": "11.99",
"currency": "USD"
}
},
{
"id": "7a2e9f14-b532-48d1-ae73-c9f2d8e61b4a",
"external_id": "sp_sub_8x2k4m",
"name": "Premium Individual",
"description": "Ad-free music streaming for one account",
"merchant": {
"id": 13,
"name": "Spotify",
"category": "Streaming",
"logo": "https://knot.imgix.net/merchants/spotify-logo.png",
"parent_merchant": null
},
"status": "ACTIVE",
"billing_cycle": "RECURRING_MONTHLY",
"next_billing_date": "2026-03-10",
"last_billing_date": "2026-02-10",
"start_date": "2024-09-01",
"expiration_date": null,
"payment_method": {
"type": "CARD",
"brand": "VISA",
"last_four": "1234"
},
"cancel_instructions": "You can cancel your subscription at any time from your account settings.",
"is_paid": true,
"is_family_plan": false,
"is_cancellable": true,
"price": {
"total": "12.99",
"currency": "USD"
}
}
],
"next_cursor": "eyJpZCI6MjI3ODEsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
"limit": 100
}Authorizations
Body
application/json
The input parameters required for listing subscriptions.
Cursor token pointing to the last subscription retrieved. The /subscriptions/list endpoint uses cursor-based pagination to track which subscriptions have already been seen, minimizing data redundancy.
On the first call, the endpoint returns all subscriptions paginated. In subsequent calls, only subscriptions after the next cursor are provided.
Example:
"eyJpZCI6MjI3ODEsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0"
Was this page helpful?