{ "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. You'll continue to have access until May 30, 2026. You will not be charged again unless you restart your subscription.", "is_paid": true, "is_family_plan": false, "is_cancellable": true, "price": { "total": "11.99", "currency": "USD" }}
{ "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. You'll continue to have access until May 30, 2026. You will not be charged again unless you restart your subscription.", "is_paid": true, "is_family_plan": false, "is_cancellable": true, "price": { "total": "11.99", "currency": "USD" }}
Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password. Use your client_id as the username and your secret as the password value.
Instructions for cancelling the subscription, if available.
Example:
"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. You'll continue to have access until May 30, 2026. You will not be charged again unless you restart your subscription."
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Knot","description":"Guides and API reference for integrating Knot products, such as CardSwitcher and Supernova","colors":{"primary":"#0F0E0E","light":"#D8D8D8","dark":"#0F0E0E"},"logo":{"light":"https://mintcdn.com/knot/VBuG2prLV3p6xOTo/logo/light.svg?fit=max\u0026auto=format\u0026n=VBuG2prLV3p6xOTo\u0026q=85\u0026s=fd06fd47577a90c8e224072b4be0e5dd","dark":"https://mintcdn.com/knot/VBuG2prLV3p6xOTo/logo/dark.svg?fit=max\u0026auto=format\u0026n=VBuG2prLV3p6xOTo\u0026q=85\u0026s=3ec182904f4fcae0296bd34329d1ffa0","href":"https://www.knotapi.com"},"favicon":"https://mintcdn.com/knot/VBuG2prLV3p6xOTo/favicon.svg?fit=max\u0026auto=format\u0026n=VBuG2prLV3p6xOTo\u0026q=85\u0026s=47782d8aa08991b4c5e03be1fb07dcd0","api":{"openapi":"api-reference/openapi.json"},"navbar":{"links":[{"href":"https://knotapi.com/careers","label":"We're hiring"}],"primary":{"type":"button","label":"Dashboard","href":"https://dashboard.knotapi.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/knotapi","x":"https://x.com/KnotAPIs"},"links":[{"header":"Products","items":[{"label":"CardSwitcher™","href":"https://www.knotapi.com/cardswitcher"},{"label":"TransactionLink™","href":"https://www.knotapi.com/txn-link"},{"label":"AgenticShopping™","href":"https://www.knotapi.com/agentic-shopping"},{"label":"AccountUpdater™","href":"https://www.knotapi.com/accountupdater"}]},{"header":"Use Cases","items":[{"label":"Personal Banking","href":"https://www.knotapi.com/personal-banking"},{"label":"Business Banking","href":"https://www.knotapi.com/business-banking"},{"label":"Merchants","href":"https://www.knotapi.com/merchants"},{"label":"BaaS","href":"https://www.knotapi.com/baas"}]},{"header":"Company","items":[{"label":"About Us","href":"https://www.knotapi.com/about-us"},{"label":"Trust Center","href":"https://trust.knotapi.com/"},{"label":"Contact","href":"https://www.knotapi.com/contact"},{"label":"Careers","href":"https://knotapi.com/careers"}]},{"header":"Legal","items":[{"label":"Terms \u0026 Conditions","href":"https://www.knotapi.com/terms"},{"label":"Privacy Policy","href":"https://www.knotapi.com/privacy"}]}]},"search":{"prompt":"Search or ask AI..."},"seo":{"organization":{"name":"Knot","url":"https://www.knotapi.com","sameAs":["https://www.linkedin.com/company/knotapi","https://x.com/KnotAPIs"]}},"fonts":{"heading":{"family":"Geist","weight":500},"body":{"family":"Geist","weight":400}},"styling":{"codeblocks":"system","latex":false},"integrations":{"segment":{"key":"2VQVWDiEQctuTfDIREdqA3l0KGlREyN5"}},"errors":{"404":{"redirect":false,"title":"Hello there...","description":"This page doesn’t exist, but your next opportunity might 👀. Check out [open roles at Knot](https://knotapi.com/careers). Looking for documentation? Start at the [introduction](/), browse the [documentation index (llms.txt)](/llms.txt) or [sitemap](/sitemap.xml), or [contact Knot](https://www.knotapi.com/contact/)."}},"contextual":{"options":["assistant","copy","add-mcp","chatgpt","claude","cursor","vscode"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"knot","hasAudioNarration":true,"actualSubdomain":"knot","customDomains":["docs.knotapi.com"],"gitSource":{"type":"github","owner":"millionscard","repo":"knot-api-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae5e9f23badfbce406c289d","collectionId":"38f901f9-21df-4d2e-a4e4-73c005aad25f","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae5e9f23badfbce406c289d"},"feedback":{"edits":false,"thumbs":true,"issues":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae5e9f23badfbce406c289d","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Docs","count":76},{"language":"default","tag":"API Reference","count":48},{"language":"default","tag":"Webhook Events","count":28},{"language":"default","tag":"CardSwitcher","count":19},{"language":"default","tag":"TransactionLink","count":16},{"language":"default","tag":"Merchant Account Linking","count":13},{"language":"default","tag":"SubscriptionManager","count":12},{"language":"default","tag":"SDK","count":12},{"language":"default","tag":"Shopping","count":9},{"language":"default","tag":"Use Cases","count":8}],"searchSettings":{"showContentSnippets":true,"isFiltersEnabled":false}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":false,"deflection":{"enabled":true,"email":"product@knotapi.com"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"6900107fa0d9fd2c40a2a17e","deploymentId":"67259f59f39b3bc1a898c425","questionText":"How do I get a list of available merchants?","status":"active","generatedBy":"manual","createdAt":"2025-10-28T00:38:23.158Z","updatedAt":"2025-10-28T00:38:23.158Z","__v":0},{"_id":"69001016a0d9fd2c40a27dce","deploymentId":"67259f59f39b3bc1a898c425","questionText":"How do I send card data to Knot?","status":"active","generatedBy":"manual","createdAt":"2025-10-28T00:36:38.949Z","updatedAt":"2025-10-28T00:36:38.949Z","__v":0},{"_id":"69000fe3a0d9fd2c40a26975","deploymentId":"67259f59f39b3bc1a898c425","questionText":"How do I create a session?","status":"active","generatedBy":"manual","createdAt":"2025-10-28T00:35:47.577Z","updatedAt":"2025-10-28T00:35:47.577Z","__v":0}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":"html[data-current-path=\"/api-reference/work-at-knot/apply\"] #sidebar{display:none}html[data-current-path=\"/api-reference/work-at-knot/apply\"] #content-area{margin-left:0;padding-left:0;max-width:100%}"}],"page":{"pagePath":"api-reference/products/subscriptions/get-by-id","slug":"/api-reference/products/subscriptions/get-by-id","pageMetadata":{"title":"Get Subscription By ID","openapi":"GET /subscriptions/{id}","description":"Get a specific subscription by ID.","href":"/api-reference/products/subscriptions/get-by-id"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Get a specific subscription by ID.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Get Subscription By ID","openapi":"GET /subscriptions/{id}","description":"Get a specific subscription by ID.","href":"/api-reference/products/subscriptions/get-by-id"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"subscription_get_by_id","summary":"Get Subscription By ID","description":"Get a specific subscription by ID.","x-mint":{"mcp":{"enabled":true,"name":"get-subscription-by-id","description":"Get a specific subscription by ID."}},"parameters":["45a4d9e8-cef3-4690-a5f6-dc994cf13436"],"responses":{"200":"ba448b0c-15ec-48d4-82bf-571a2082fbba","400":"55236236-0b7d-4e9b-8b62-62f6f320ca59","401":"4ac3ca09-6344-4053-88ae-ef5d6ef18302","500":"ccd72512-8cc9-448d-b406-b10baffdcce7"},"method":"get","type":"path","servers":["f703bc26-40b5-4c63-a941-b4a6ad91db2e"],"security":["c60b52a8-bfc8-4648-9d2d-4145cb489db4"],"path":"/subscriptions/{id}","baseUrlOptions":["https://development.knotapi.com"],"title":"Get Subscription By ID","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"45a4d9e8-cef3-4690-a5f6-dc994cf13436":{"name":"id","in":"path","required":true,"schema":{"type":"string","example":"13da3c28-a068-4642-9ce2-b730cfda5f5f","isRequired":true,"description":"Unique identifier for a subscription.","uniqueKey":"","typeLabel":"string"},"description":"Unique identifier for a subscription."}},"responses":{"ba448b0c-15ec-48d4-82bf-571a2082fbba":{"description":"Successful request.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier for the subscription.","example":"13da3c28-a068-4642-9ce2-b730cfda5f5f","uniqueKey":"id","typeLabel":"string"},"external_id":{"type":"string","description":"External identifier for the subscription provided by the merchant.","example":"a9x7bq2lmw5p","uniqueKey":"external_id","typeLabel":"string"},"name":{"type":"string","description":"Human-readable subscription name as displayed by the merchant.","example":"Disney+, Hulu Bundle Premium","uniqueKey":"name","typeLabel":"string"},"description":{"oneOf":[{"type":"string","description":"Description of the subscription plan.","example":"Ad-free streaming with Disney+ and Hulu","uniqueKey":"description.oneOf.0","typeLabel":"string"},{"type":"null","description":"Description of the subscription plan.","example":"Ad-free streaming with Disney+ and Hulu","uniqueKey":"description.oneOf.1","typeLabel":"null"}],"uniqueKey":"description","typeLabel":"string | null"},"merchant":{"type":"object","description":"The merchant account linked by the user.","properties":{"id":{"type":"integer","description":"Unique identifier for the merchant.","example":18,"uniqueKey":"merchant.id","typeLabel":"integer"},"name":{"type":"string","description":"Name of the merchant.","example":"Hulu","uniqueKey":"merchant.name","typeLabel":"string"},"category":{"type":"string","description":"Category of the merchant.","example":"Streaming","uniqueKey":"merchant.category","typeLabel":"string"},"logo":{"type":"string","description":"URL of the merchant's logo.","example":"https://knot.imgix.net/merchants/KBQ5j6cN010PPpwbO7RpKGyDrCpsZ91FRhwnZp5u.png","uniqueKey":"merchant.logo","typeLabel":"string"},"parent_merchant":{"oneOf":[{"type":"object","description":"Parent merchant of the merchant account linked by the user, or `null` when the linked merchant has no parent. E.g. `Google` is the parent of `YouTube TV` and `Amazon` is the parent of `Prime Video`.","properties":{"id":{"type":"integer","description":"Unique identifier for the merchant.","example":18,"uniqueKey":"merchant.parent_merchant.oneOf.0.id","typeLabel":"integer"},"name":{"type":"string","description":"Name of the merchant.","example":"Hulu","uniqueKey":"merchant.parent_merchant.oneOf.0.name","typeLabel":"string"},"category":{"type":"string","description":"Category of the merchant.","example":"Streaming","uniqueKey":"merchant.parent_merchant.oneOf.0.category","typeLabel":"string"},"logo":{"type":"string","description":"URL of the merchant's logo.","example":"https://knot.imgix.net/merchants/KBQ5j6cN010PPpwbO7RpKGyDrCpsZ91FRhwnZp5u.png","uniqueKey":"merchant.parent_merchant.oneOf.0.logo","typeLabel":"string"}},"uniqueKey":"merchant.parent_merchant.oneOf.0","typeLabel":"object"},{"type":"null","description":"Parent merchant of the merchant account linked by the user, or `null` when the linked merchant has no parent. E.g. `Google` is the parent of `YouTube TV` and `Amazon` is the parent of `Prime Video`.","uniqueKey":"merchant.parent_merchant.oneOf.1","typeLabel":"null"}],"uniqueKey":"merchant.parent_merchant","typeLabel":"object | null"}},"uniqueKey":"merchant","typeLabel":"object"},"status":{"oneOf":[{"type":"string","title":"ACTIVE","description":"Billing and access ongoing.","const":"ACTIVE","example":"ACTIVE","uniqueKey":"status.oneOf.0","typeLabel":"string"},{"type":"string","title":"ACTIVE_CANCELLATION","description":"Cancelled, but still active until end of billing period.","const":"ACTIVE_CANCELLATION","example":"ACTIVE","uniqueKey":"status.oneOf.1","typeLabel":"string"},{"type":"string","title":"ACTIVE_PLAN_CHANGE","description":"Plan change queued.","const":"ACTIVE_PLAN_CHANGE","example":"ACTIVE","uniqueKey":"status.oneOf.2","typeLabel":"string"},{"type":"string","title":"ACTIVE_SUSPENSION","description":"Service active but on a temporary grace period often due to payment failure. Likely to become suspended if payment is not made.","const":"ACTIVE_SUSPENSION","example":"ACTIVE","uniqueKey":"status.oneOf.3","typeLabel":"string"},{"type":"string","title":"PENDING","description":"Not yet billed or activated.","const":"PENDING","example":"ACTIVE","uniqueKey":"status.oneOf.4","typeLabel":"string"},{"type":"string","title":"PAUSED","description":"Temporarily paused by user.","const":"PAUSED","example":"ACTIVE","uniqueKey":"status.oneOf.5","typeLabel":"string"},{"type":"string","title":"CANCELLED","description":"Fully terminated.","const":"CANCELLED","example":"ACTIVE","uniqueKey":"status.oneOf.6","typeLabel":"string"},{"type":"string","title":"SUSPENDED","description":"Service suspended by merchant, often due to payment failure.","const":"SUSPENDED","example":"ACTIVE","uniqueKey":"status.oneOf.7","typeLabel":"string"},{"type":"string","title":"UNRECOGNIZED","description":"Status could not be determined.","const":"UNRECOGNIZED","example":"ACTIVE","uniqueKey":"status.oneOf.8","typeLabel":"string"}],"uniqueKey":"status","typeLabel":"string"},"billing_cycle":{"type":"string","enum":["RECURRING_MONTHLY","RECURRING_BIMONTHLY","RECURRING_WEEKLY","RECURRING_BIWEEKLY","RECURRING_QUARTERLY","RECURRING_SEMIANNUALLY","RECURRING_ANNUALLY","RECURRING_DAILY","ONE_TIME","UNRECOGNIZED"],"description":"Billing cycle of the subscription.","example":"RECURRING_MONTHLY","uniqueKey":"billing_cycle","typeLabel":"enum\u003cstring>"},"next_billing_date":{"oneOf":[{"type":"string","format":"date","description":"Date of the next scheduled charge in UTC. ISO 8601 format (YYYY-MM-DD).","example":"2026-02-10","uniqueKey":"next_billing_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Date of the next scheduled charge in UTC. ISO 8601 format (YYYY-MM-DD).","example":"2026-02-10","uniqueKey":"next_billing_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_billing_date","typeLabel":"string\u003cdate> | null"},"last_billing_date":{"oneOf":[{"type":"string","format":"date","description":"Date of the most recent attempted charge in UTC. ISO 8601 format (YYYY-MM-DD).","example":"2026-01-10","uniqueKey":"last_billing_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Date of the most recent attempted charge in UTC. ISO 8601 format (YYYY-MM-DD).","example":"2026-01-10","uniqueKey":"last_billing_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"last_billing_date","typeLabel":"string\u003cdate> | null"},"start_date":{"oneOf":[{"type":"string","format":"date","description":"Start date for the subscription in UTC. ISO 8601 format (YYYY-MM-DD).","example":"2025-06-15","uniqueKey":"start_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Start date for the subscription in UTC. ISO 8601 format (YYYY-MM-DD).","example":"2025-06-15","uniqueKey":"start_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"start_date","typeLabel":"string\u003cdate> | null"},"expiration_date":{"oneOf":[{"type":"string","format":"date","description":"Date of the loss of access to the subscription due to cancellation or other means in UTC. ISO 8601 format (YYYY-MM-DD).","example":null,"uniqueKey":"expiration_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","description":"Date of the loss of access to the subscription due to cancellation or other means in UTC. ISO 8601 format (YYYY-MM-DD).","example":null,"uniqueKey":"expiration_date.oneOf.1","typeLabel":"null"}],"uniqueKey":"expiration_date","typeLabel":"string\u003cdate> | null"},"payment_method":{"type":"object","properties":{"type":{"type":"string","enum":["CARD","THIRD_PARTY","APPLE_PAY","GOOGLE_PAY","AMAZON_PAY","PAYPAL","CASH_APP","VENMO","AFFIRM","KLARNA","GIFT_CARD","CASH","BANK_ACCOUNT","LOYALTY_POINTS","UNRECOGNIZED"],"description":"Type of the payment method.","example":"CARD","uniqueKey":"payment_method.type","typeLabel":"enum\u003cstring>"},"brand":{"oneOf":[{"type":"string","description":"Brand of the payment method.","example":"VISA","uniqueKey":"payment_method.brand.oneOf.0","typeLabel":"string"},{"type":"null","description":"Brand of the payment method.","example":"VISA","uniqueKey":"payment_method.brand.oneOf.1","typeLabel":"null"}],"uniqueKey":"payment_method.brand","typeLabel":"string | null"},"last_four":{"oneOf":[{"type":"string","description":"Last 4 digits of the payment method, if a payment card.","example":"1234","uniqueKey":"payment_method.last_four.oneOf.0","typeLabel":"string"},{"type":"null","description":"Last 4 digits of the payment method, if a payment card.","example":"1234","uniqueKey":"payment_method.last_four.oneOf.1","typeLabel":"null"}],"uniqueKey":"payment_method.last_four","typeLabel":"string | null"}},"example":{"type":"CARD","brand":"VISA","last_four":"1234"},"uniqueKey":"payment_method","typeLabel":"object"},"cancel_instructions":{"oneOf":[{"type":"string","description":"Instructions for cancelling the subscription, if available.","example":"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. You'll continue to have access until May 30, 2026. You will not be charged again unless you restart your subscription.","uniqueKey":"cancel_instructions.oneOf.0","typeLabel":"string"},{"type":"null","description":"Instructions for cancelling the subscription, if available.","example":"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. You'll continue to have access until May 30, 2026. You will not be charged again unless you restart your subscription.","uniqueKey":"cancel_instructions.oneOf.1","typeLabel":"null"}],"uniqueKey":"cancel_instructions","typeLabel":"string | null"},"is_paid":{"oneOf":[{"type":"boolean","description":"Whether the subscription is a paid plan or free.","example":true,"uniqueKey":"is_paid.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the subscription is a paid plan or free.","example":true,"uniqueKey":"is_paid.oneOf.1","typeLabel":"null"}],"uniqueKey":"is_paid","typeLabel":"boolean | null"},"is_free_trial":{"oneOf":[{"type":"boolean","description":"Whether the subscription is currently in a free trial period, or was suspended or cancelled while in one.","example":false,"uniqueKey":"is_free_trial.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the subscription is currently in a free trial period, or was suspended or cancelled while in one.","example":false,"uniqueKey":"is_free_trial.oneOf.1","typeLabel":"null"}],"uniqueKey":"is_free_trial","typeLabel":"boolean | null"},"is_family_plan":{"oneOf":[{"type":"boolean","description":"Whether the subscription is a family plan.","example":false,"uniqueKey":"is_family_plan.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the subscription is a family plan.","example":false,"uniqueKey":"is_family_plan.oneOf.1","typeLabel":"null"}],"uniqueKey":"is_family_plan","typeLabel":"boolean | null"},"is_cancellable":{"type":"boolean","description":"Indicates whether the merchant has marked this subscription as cancellable.","example":true,"uniqueKey":"is_cancellable","typeLabel":"boolean"},"price":{"oneOf":[{"type":"object","properties":{"total":{"type":"string","description":"Total price of the subscription.","example":"11.99","uniqueKey":"price.oneOf.0.total","typeLabel":"string"},"currency":{"type":"string","description":"Currency of the price. ISO 4217 format.","example":"USD","uniqueKey":"price.oneOf.0.currency","typeLabel":"string"}},"uniqueKey":"price.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"price.oneOf.1","typeLabel":"null"}],"uniqueKey":"price","typeLabel":"object | null"}},"example":{"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"},"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. You'll continue to have access until May 30, 2026. You will not be charged again unless you restart your subscription.","is_paid":true,"is_family_plan":false,"is_cancellable":true,"price":{"total":"11.99","currency":"USD"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Hulu":{"title":"Hulu","value":{"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. You'll continue to have access until May 30, 2026. You will not be charged again unless you restart your subscription.","is_paid":true,"is_family_plan":false,"is_cancellable":true,"price":{"total":"11.99","currency":"USD"}}},"Spotify":{"title":"Spotify","value":{"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. Your cancellation will take effect at the end of your current billing period. You'll continue to have access until May 30, 2026. You will not be charged again unless you restart your subscription.","is_paid":true,"is_family_plan":false,"is_cancellable":true,"price":{"total":"12.99","currency":"USD"}}},"YouTubeTV":{"title":"YouTubeTV","value":{"id":"b4c1e8a3-9d27-4f6e-a1b3-8c5d2e7f9a01","external_id":"a9x7bq2lmw5p","name":"Google Cloud Storage, 100GB","description":"100 GB of cloud storage shared across Google Drive, Gmail, and Google Photos","merchant":{"id":25,"name":"YouTube TV","category":"Streaming","logo":"https://knot.imgix.net/merchants/youtube-tv-logo.png","parent_merchant":{"id":129,"name":"Google","category":"Online shopping","logo":"https://knot.imgix.net/merchants/google-logo.png"}},"status":"ACTIVE","billing_cycle":"RECURRING_MONTHLY","next_billing_date":"2026-07-01","last_billing_date":"2026-06-01","start_date":"2025-03-15","expiration_date":null,"payment_method":{"type":"CARD","brand":"VISA","last_four":"1234"},"cancel_instructions":null,"is_paid":true,"is_family_plan":false,"is_cancellable":true,"price":{"total":"9.99","currency":"USD"}}}},"exampleType":"examples"}},"exampleType":"examples"},"55236236-0b7d-4e9b-8b62-62f6f320ca59":{"description":"Bad request.","content":{"application/json":{"schema":{"type":"object","properties":{"error_type":{"type":"string","description":"Type of error.","enum":["INVALID_INPUT","INVALID_REQUEST","USER_ERROR","SESSION_ERROR","MERCHANT_ACCOUNT_ERROR","MERCHANT_ERROR","SUBSCRIPTION_ERROR","TRANSACTION_ERROR","CART_ERROR","WEBHOOK_ENDPOINT_ERROR","REQUEST_LOG_ERROR"],"example":"INVALID_REQUEST","uniqueKey":"error_type","typeLabel":"enum\u003cstring>"},"error_code":{"type":"string","description":"Error code.","enum":["INVALID_API_KEYS","INVALID_FIELD","INVALID_JWE","INVALID_CURSOR_FORMAT","USER_NOT_FOUND","MERCHANT_ACCOUNT_NOT_FOUND","MERCHANT_ACCOUNT_DISCONNECTED","SESSION_NOT_FOUND","EXTEND_NOT_SUPPORTED","MERCHANT_UNAVAILABLE","NO_ACCESS","TRANSACTION_NOT_FOUND","NO_TRANSACTIONS","SUBSCRIPTION_NOT_FOUND","CANCELLABLE_SUBSCRIPTION_NOT_FOUND","MULTIPLE_CANCELLABLE_SUBSCRIPTIONS_FOUND","ONGOING_OPERATION","CART_NOT_FOUND","FULFILLMENT_NOT_FOUND","INVALID_ACCESS_TOKEN","INSUFFICIENT_SCOPE","INSUFFICIENT_ROLE","WEBHOOK_ENDPOINT_NOT_FOUND","WEBHOOK_ENDPOINT_LIMIT_REACHED","WEBHOOK_ENDPOINT_ALREADY_EXISTS","RATE_LIMIT_EXCEEDED","ENVIRONMENT_MISMATCH","REQUEST_LOG_NOT_FOUND","REQUEST_LOG_QUERY_TIMEOUT"],"example":"INVALID_FIELD","uniqueKey":"error_code","typeLabel":"enum\u003cstring>"},"error_message":{"type":"string","description":"Detailed error message.","example":"The limit may not be greater than 10.","uniqueKey":"error_message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"SubscriptionNotFound":{"title":"SubscriptionNotFound","value":{"error_type":"SUBSCRIPTION_ERROR","error_code":"SUBSCRIPTION_NOT_FOUND","error_message":"The subscription was not found. Please check the ID provided."}},"NoAccess":{"title":"NoAccess","value":{"error_type":"INVALID_REQUEST","error_code":"NO_ACCESS","error_message":"Please contact Knot for access to this endpoint."}}},"exampleType":"examples"}},"exampleType":"examples"},"4ac3ca09-6344-4053-88ae-ef5d6ef18302":{"description":"Unauthorized request.","content":{"application/json":{"schema":{"type":"object","properties":{"error_type":{"type":"string","description":"Type of error.","enum":["INVALID_INPUT","INVALID_REQUEST","USER_ERROR","SESSION_ERROR","MERCHANT_ACCOUNT_ERROR","MERCHANT_ERROR","SUBSCRIPTION_ERROR","TRANSACTION_ERROR","CART_ERROR","WEBHOOK_ENDPOINT_ERROR","REQUEST_LOG_ERROR"],"example":"INVALID_REQUEST","uniqueKey":"error_type","typeLabel":"enum\u003cstring>"},"error_code":{"type":"string","description":"Error code.","enum":["INVALID_API_KEYS","INVALID_FIELD","INVALID_JWE","INVALID_CURSOR_FORMAT","USER_NOT_FOUND","MERCHANT_ACCOUNT_NOT_FOUND","MERCHANT_ACCOUNT_DISCONNECTED","SESSION_NOT_FOUND","EXTEND_NOT_SUPPORTED","MERCHANT_UNAVAILABLE","NO_ACCESS","TRANSACTION_NOT_FOUND","NO_TRANSACTIONS","SUBSCRIPTION_NOT_FOUND","CANCELLABLE_SUBSCRIPTION_NOT_FOUND","MULTIPLE_CANCELLABLE_SUBSCRIPTIONS_FOUND","ONGOING_OPERATION","CART_NOT_FOUND","FULFILLMENT_NOT_FOUND","INVALID_ACCESS_TOKEN","INSUFFICIENT_SCOPE","INSUFFICIENT_ROLE","WEBHOOK_ENDPOINT_NOT_FOUND","WEBHOOK_ENDPOINT_LIMIT_REACHED","WEBHOOK_ENDPOINT_ALREADY_EXISTS","RATE_LIMIT_EXCEEDED","ENVIRONMENT_MISMATCH","REQUEST_LOG_NOT_FOUND","REQUEST_LOG_QUERY_TIMEOUT"],"example":"INVALID_FIELD","uniqueKey":"error_code","typeLabel":"enum\u003cstring>"},"error_message":{"type":"string","description":"Detailed error message.","example":"The limit may not be greater than 10.","uniqueKey":"error_message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"AuthFailed":{"title":"AuthFailed","value":{"error_type":"INVALID_INPUT","error_code":"INVALID_API_KEYS","error_message":"Invalid client_id or secret provided."}}},"exampleType":"examples"}},"exampleType":"examples"},"ccd72512-8cc9-448d-b406-b10baffdcce7":{"description":"Internal server error.","content":{"application/json":{"schema":{"type":"object","properties":{"error_type":{"type":"string","description":"Type of error.","enum":["INVALID_INPUT","INVALID_REQUEST","USER_ERROR","SESSION_ERROR","MERCHANT_ACCOUNT_ERROR","MERCHANT_ERROR","SUBSCRIPTION_ERROR","TRANSACTION_ERROR","CART_ERROR","WEBHOOK_ENDPOINT_ERROR","REQUEST_LOG_ERROR"],"example":"INVALID_REQUEST","uniqueKey":"error_type","typeLabel":"enum\u003cstring>"},"error_code":{"type":"string","description":"Error code.","enum":["INVALID_API_KEYS","INVALID_FIELD","INVALID_JWE","INVALID_CURSOR_FORMAT","USER_NOT_FOUND","MERCHANT_ACCOUNT_NOT_FOUND","MERCHANT_ACCOUNT_DISCONNECTED","SESSION_NOT_FOUND","EXTEND_NOT_SUPPORTED","MERCHANT_UNAVAILABLE","NO_ACCESS","TRANSACTION_NOT_FOUND","NO_TRANSACTIONS","SUBSCRIPTION_NOT_FOUND","CANCELLABLE_SUBSCRIPTION_NOT_FOUND","MULTIPLE_CANCELLABLE_SUBSCRIPTIONS_FOUND","ONGOING_OPERATION","CART_NOT_FOUND","FULFILLMENT_NOT_FOUND","INVALID_ACCESS_TOKEN","INSUFFICIENT_SCOPE","INSUFFICIENT_ROLE","WEBHOOK_ENDPOINT_NOT_FOUND","WEBHOOK_ENDPOINT_LIMIT_REACHED","WEBHOOK_ENDPOINT_ALREADY_EXISTS","RATE_LIMIT_EXCEEDED","ENVIRONMENT_MISMATCH","REQUEST_LOG_NOT_FOUND","REQUEST_LOG_QUERY_TIMEOUT"],"example":"INVALID_FIELD","uniqueKey":"error_code","typeLabel":"enum\u003cstring>"},"error_message":{"type":"string","description":"Detailed error message.","example":"The limit may not be greater than 10.","uniqueKey":"error_message","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"InternalServerError":{"title":"InternalServerError","value":{"message":"Server Error"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"c60b52a8-bfc8-4648-9d2d-4145cb489db4":{"basicAuth":{"type":"http","scheme":"basic","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`. Use your `client_id` as the `username` and your `secret` as the `password` value.","scopes":[],"schemeName":"basicAuth"}}},"servers":{"f703bc26-40b5-4c63-a941-b4a6ad91db2e":{"url":"https://development.knotapi.com","description":"Development server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"basic","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`. Use your `client_id` as the `username` and your `secret` as the `password` value.","scopes":[],"schemeName":"basicAuth"},"schema":{"title":"Basic Auth","type":"object","description":"Basic authentication header of the form `Basic \u003cencoded-value>`, where `\u003cencoded-value>` is the base64-encoded string `username:password`. Use your `client_id` as the `username` and your `secret` as the `password` value.","isRequired":true,"properties":{"username":{"type":"string","uniqueKey":"username","isRequired":true,"typeLabel":"string","deprecated":false},"password":{"type":"string","uniqueKey":"password","isRequired":true,"typeLabel":"string","deprecated":false}},"additionalProperties":false,"deprecated":false},"schemeName":"basicAuth","name":"Authorization"}],"title":"basicAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"knot","siteName":"Knot","title":"Get Subscription By ID - Knot","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-02-04T18:21:49.370Z","originalFileLocation":"api-reference/products/subscriptions/get-by-id.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Get a specific subscription by ID.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Knot\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Subscription By ID - Knot\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a specific subscription by ID.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Knot\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.knotapi.com/api-reference/products/subscriptions/get-by-id\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://knot.mintlify.app/_mintlify/api/og/v2?division=SubscriptionManager\u0026amp;title=Get+Subscription+By+ID\u0026amp;description=Get+a+specific+subscription+by+ID.\u0026amp;theme=c2017d1867bb9f3af1e4a591\u0026amp;signature=5bb6f14b272a6ffca6f5ee06da3a6542a9e9dd870244b823706d55cdb1b40ad5\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Subscription By ID - Knot\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a specific subscription by ID.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://knot.mintlify.app/_mintlify/api/og/v2?division=SubscriptionManager\u0026amp;title=Get+Subscription+By+ID\u0026amp;description=Get+a+specific+subscription+by+ID.\u0026amp;theme=c2017d1867bb9f3af1e4a591\u0026amp;signature=5bb6f14b272a6ffca6f5ee06da3a6542a9e9dd870244b823706d55cdb1b40ad5\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/knot/X2cfOEMCNQ4RTMjp/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Knot\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0F0E0E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.knotapi.com/api-reference/products/subscriptions/get-by-id\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/products/subscriptions/get-by-id.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.knotapi.com/#organization\",\"name\":\"Knot\",\"url\":\"https://www.knotapi.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/knot/VBuG2prLV3p6xOTo/logo/light.svg?fit=max\u0026auto=format\u0026n=VBuG2prLV3p6xOTo\u0026q=85\u0026s=fd06fd47577a90c8e224072b4be0e5dd\"},\"sameAs\":[\"https://www.linkedin.com/company/knotapi\",\"https://x.com/KnotAPIs\"]},{\"@type\":\"WebSite\",\"@id\":\"https://docs.knotapi.com#website\",\"name\":\"Knot\",\"url\":\"https://docs.knotapi.com\",\"publisher\":{\"@id\":\"https://www.knotapi.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.knotapi.com/api-reference/products/subscriptions/get-by-id#webpage\",\"url\":\"https://docs.knotapi.com/api-reference/products/subscriptions/get-by-id\",\"name\":\"Get Subscription By ID\",\"description\":\"Get a specific subscription by ID.\",\"dateModified\":\"2026-02-04T18:21:49.370Z\",\"isPartOf\":{\"@id\":\"https://docs.knotapi.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.knotapi.com/api-reference/products/subscriptions/get-by-id#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.knotapi.com/api-reference/products/subscriptions/get-by-id#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"SubscriptionManager\",\"item\":\"https://docs.knotapi.com/api-reference/products/subscriptions/subscription-object\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Subscription By ID\",\"item\":\"https://docs.knotapi.com/api-reference/products/subscriptions/get-by-id\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.knotapi.com/api-reference/products/subscriptions/get-by-id#apireference\",\"headline\":\"Get Subscription By ID\",\"name\":\"Get Subscription By ID\",\"description\":\"Get a specific subscription by ID.\",\"url\":\"https://docs.knotapi.com/api-reference/products/subscriptions/get-by-id\",\"mainEntityOfPage\":{\"@id\":\"https://docs.knotapi.com/api-reference/products/subscriptions/get-by-id#webpage\"},\"dateModified\":\"2026-02-04T18:21:49.370Z\",\"publisher\":{\"@id\":\"https://www.knotapi.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.knotapi.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Knot\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Knot","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"API Reference","groups":[{"group":"Overview","pages":[{"title":"Authentication","sidebarTitle":"Authentication","href":"/api-reference/authentication"},{"title":"Versioning","href":"/api-reference/versioning"},{"title":"mTLS","href":"/api-reference/mTLS"}]},{"group":"Supernova","pages":[{"title":"Create MCP Token","openapi":"POST /mcp/tokens/create","href":"/api-reference/mcp-tokens/create-mcp-token"},{"title":"Revoke MCP Tokens","openapi":"POST /mcp/tokens/revoke","href":"/api-reference/mcp-tokens/revoke-mcp-tokens"}]},{"group":"Development","pages":[{"title":"Link Account","openapi":"POST /development/accounts/link","href":"/api-reference/development/link-account"}]},{"group":"Sessions","pages":[{"title":"Create Session","openapi":"POST /session/create","href":"/api-reference/sessions/create-session"},{"title":"Extend Session","openapi":"POST /session/extend","href":"/api-reference/sessions/extend-session"}]},{"group":"CardSwitcher","pages":[{"title":"Retrieve JWK","openapi":"GET /jwe/key","href":"/api-reference/products/card-switcher/retrieve-jwk"},{"title":"Switch Card JWE","openapi":"api-reference/openapi.json POST /card","href":"/api-reference/products/card-switcher/switch-card-jwe"},{"title":"Switch Card","openapi":"api-reference/openapi_secure.json POST /card","href":"/api-reference/products/card-switcher/switch-card"},{"title":"Switch Bank Account JWE","openapi":"api-reference/openapi.json POST /bank-account","href":"/api-reference/products/card-switcher/switch-bank-account-jwe"},{"title":"Create Knot Zero Link","openapi":"POST /zero-link/create","href":"/api-reference/products/card-switcher/create-knot-zero-link"},{"title":"Create Knot Zero Links (Batch)","openapi":"POST /zero-link/batch/create","href":"/api-reference/products/card-switcher/create-knot-zero-links-batch"},{"title":"Revoke Knot Zero Links","openapi":"POST /zero-link/revoke","href":"/api-reference/products/card-switcher/revoke-knot-zero-links"}]},{"group":"TransactionLink","pages":[{"title":"The Transaction Object","href":"/api-reference/products/transaction-link/transaction-object"},{"title":"Sync Transactions","openapi":"POST /transactions/sync","href":"/api-reference/products/transaction-link/sync"},{"title":"Get Transaction By ID","openapi":"GET /transactions/{id}","href":"/api-reference/products/transaction-link/get-by-id"},{"title":"Refresh Transactions","openapi":"POST /transactions/refresh","href":"/api-reference/products/transaction-link/refresh"}]},{"group":"SubscriptionManager","pages":[{"title":"The Subscription Object","description":null,"href":"/api-reference/products/subscriptions/subscription-object"},{"title":"Get Subscription By ID","openapi":"GET /subscriptions/{id}","href":"/api-reference/products/subscriptions/get-by-id"},{"title":"List Subscriptions","openapi":"POST /subscriptions/list","description":"List a user's subscriptions using cursor-based pagination.","href":"/api-reference/products/subscriptions/list"},{"title":"Refresh Subscriptions","openapi":"POST /subscriptions/refresh","href":"/api-reference/products/subscriptions/refresh"},{"title":"Cancel Subscription By ID","openapi":"POST /subscriptions/{id}/cancel","href":"/api-reference/products/subscriptions/cancel"},{"title":"Cancel Subscription By Account","openapi":"POST /subscriptions/cancel","href":"/api-reference/products/subscriptions/cancel-by-account"}]},{"group":"Shopping","pages":[{"title":"Sync Cart","openapi":"POST /cart","href":"/api-reference/products/shopping/sync-cart"},{"title":"Checkout","openapi":"POST /cart/checkout","href":"/api-reference/products/shopping/checkout"}]},{"group":"Merchants","pages":[{"title":"List Merchants","openapi":"POST /merchant/list","href":"/api-reference/merchants/list-merchants"}]},{"group":"Merchant Accounts","pages":[{"title":"Get Merchant Accounts","openapi":"GET /accounts/get","href":"/api-reference/accounts/get-accounts"},{"title":"Unlink Merchant Account","openapi":"POST /accounts/unlink","href":"/api-reference/accounts/unlink-account"}]},{"group":"Detected Accounts","pages":[{"title":"Detect Accounts","openapi":"POST /detect","href":"/api-reference/products/detect/detect-accounts"},{"title":"List Detected Accounts","openapi":"POST /detected-accounts/list","href":"/api-reference/products/detect/list-detected-accounts"},{"title":"Search Detected Accounts","openapi":"POST /detected-accounts/search","href":"/api-reference/products/detect/search-detected-accounts"},{"title":"Sync Detected Accounts","openapi":"POST /detected-accounts/sync","href":"/api-reference/products/detect/sync-detected-accounts"}]},{"group":"Users","pages":[{"title":"Delete User \u0026 Data","openapi":"POST /user/delete","href":"/api-reference/users/delete-user-and-data"}]},{"group":"Audit Logs","pages":[{"title":"Get Audit Logs","openapi":"GET /audit_logs","href":"/api-reference/audit-logs/get-audit-logs"}]},{"group":"Agent Authorization","pages":[{"title":"Agent authorization","sidebarTitle":"Overview","href":"/api-reference/agent-authorization/overview"},{"title":"Request Device Code","openapi":"POST /oauth/device/code","href":"/api-reference/agent-authorization/request-device-code"},{"title":"Request Access Token","openapi":"POST /oauth/token","href":"/api-reference/agent-authorization/request-access-token"}]},{"group":"Webhook Endpoints","pages":[{"title":"Webhook Endpoint Object","href":"/api-reference/webhook-endpoints/webhook-endpoint-object"},{"title":"Create Webhook Endpoint","openapi":"POST /webhook-endpoints/create","href":"/api-reference/webhook-endpoints/create"},{"title":"Get Webhook Endpoint By ID","openapi":"GET /webhook-endpoints/{id}","href":"/api-reference/webhook-endpoints/get-by-id"},{"title":"List Webhook Endpoints","openapi":"POST /webhook-endpoints/list","href":"/api-reference/webhook-endpoints/list"},{"title":"Update Webhook Endpoint","openapi":"POST /webhook-endpoints/{id}/update","href":"/api-reference/webhook-endpoints/update"},{"title":"Delete Webhook Endpoint","openapi":"POST /webhook-endpoints/{id}/delete","href":"/api-reference/webhook-endpoints/delete"}]},{"group":"Request Logs","pages":[{"title":"Request Log Object","href":"/api-reference/request-logs/request-log-object"},{"title":"List Request Logs","openapi":"GET /request-logs","href":"/api-reference/request-logs/list"},{"title":"Get Request Log By ID","openapi":"GET /request-logs/{id}","href":"/api-reference/request-logs/get-by-id"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog/product-updates"}]}]},"basePath":"","title":"Get Subscription By ID - Knot","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":["c2aa737661","2b790eda92","2bfc744e19","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CS552b7R.js","utils-DDTCYAF2.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-De8ttokP.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DrwRDvAh.js","snippetPresets-DtAN0nWx.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-D5rWArI6.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-O2i12wsz.js","shallow-DV8xABTt.js","getApiPlaygroundDisplay-DBZ0B5Jx.js","CodeSnippet-BVi0tPUX.js","CodeSnippets-CqASbIwY.js","NarrationPlayer-Cu2BQT2J.js","types-CiTgMxws.js","Page-m07pfKpT.js","getPastedJson-DG9vsMS8.js","icon-CXzRSCr8.js","MethodPill-BdKVtEuX.js","DuplicateIcon-CZlmBrJI.js","createIcon-biFEUKPL.js","DynamicMarkdown-B54_zNBF.js","SectionHeading-DwwHK3Pt.js","axios-vUo_bRtp.js","Markdown-DfhCTwyA.js","clsx-xpJZXxdP.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BTZUMDnx.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-DqdKa2R4.js"]}