(users.subscriptions)
- list - List Subscriptions
- create - Create Free Subscription
- get - Get Subscription
- update - Update Subscription
- cancel - Cancel Subscription
List my subscriptions.
import { Polar } from "@polar-sh/sdk";
const polar = new Polar({
accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
});
async function run() {
const result = await polar.users.subscriptions.list({});
for await (const page of result) {
// Handle the page
console.log(page);
}
}
run();
The standalone function version of this method:
import { PolarCore } from "@polar-sh/sdk/core.js";
import { usersSubscriptionsList } from "@polar-sh/sdk/funcs/usersSubscriptionsList.js";
// Use `PolarCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const polar = new PolarCore({
accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
});
async function run() {
const res = await usersSubscriptionsList(polar, {});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
for await (const page of result) {
// Handle the page
console.log(page);
}
}
run();
Parameter | Type | Required | Description |
---|---|---|---|
request |
operations.UsersSubscriptionsListRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<operations.UsersSubscriptionsListResponse>
Error Object | Status Code | Content Type |
---|---|---|
errors.HTTPValidationError | 422 | application/json |
errors.SDKError | 4xx-5xx | / |
Create a subscription on a free tier.
If you want to subscribe to a paid tier, you need to create a checkout session.
import { Polar } from "@polar-sh/sdk";
const polar = new Polar({
accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
});
async function run() {
const result = await polar.users.subscriptions.create({
productId: "<value>",
});
// Handle the result
console.log(result)
}
run();
The standalone function version of this method:
import { PolarCore } from "@polar-sh/sdk/core.js";
import { usersSubscriptionsCreate } from "@polar-sh/sdk/funcs/usersSubscriptionsCreate.js";
// Use `PolarCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const polar = new PolarCore({
accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
});
async function run() {
const res = await usersSubscriptionsCreate(polar, {
productId: "<value>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
// Handle the result
console.log(result)
}
run();
Parameter | Type | Required | Description |
---|---|---|---|
request |
components.UserFreeSubscriptionCreate | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<components.UserSubscription>
Error Object | Status Code | Content Type |
---|---|---|
errors.AlreadySubscribed | 400 | application/json |
errors.ResourceNotFound | 404 | application/json |
errors.HTTPValidationError | 422 | application/json |
errors.SDKError | 4xx-5xx | / |
Get a subscription by ID.
import { Polar } from "@polar-sh/sdk";
const polar = new Polar({
accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
});
async function run() {
const result = await polar.users.subscriptions.get({
id: "<value>",
});
// Handle the result
console.log(result)
}
run();
The standalone function version of this method:
import { PolarCore } from "@polar-sh/sdk/core.js";
import { usersSubscriptionsGet } from "@polar-sh/sdk/funcs/usersSubscriptionsGet.js";
// Use `PolarCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const polar = new PolarCore({
accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
});
async function run() {
const res = await usersSubscriptionsGet(polar, {
id: "<value>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
// Handle the result
console.log(result)
}
run();
Parameter | Type | Required | Description |
---|---|---|---|
request |
operations.UsersSubscriptionsGetRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<components.UserSubscription>
Error Object | Status Code | Content Type |
---|---|---|
errors.ResourceNotFound | 404 | application/json |
errors.HTTPValidationError | 422 | application/json |
errors.SDKError | 4xx-5xx | / |
Update a subscription.
import { Polar } from "@polar-sh/sdk";
const polar = new Polar({
accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
});
async function run() {
const result = await polar.users.subscriptions.update({
id: "<value>",
userSubscriptionUpdate: {
productPriceId: "<value>",
},
});
// Handle the result
console.log(result)
}
run();
The standalone function version of this method:
import { PolarCore } from "@polar-sh/sdk/core.js";
import { usersSubscriptionsUpdate } from "@polar-sh/sdk/funcs/usersSubscriptionsUpdate.js";
// Use `PolarCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const polar = new PolarCore({
accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
});
async function run() {
const res = await usersSubscriptionsUpdate(polar, {
id: "<value>",
userSubscriptionUpdate: {
productPriceId: "<value>",
},
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
// Handle the result
console.log(result)
}
run();
Parameter | Type | Required | Description |
---|---|---|---|
request |
operations.UsersSubscriptionsUpdateRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<components.UserSubscription>
Error Object | Status Code | Content Type |
---|---|---|
errors.FreeSubscriptionUpgrade | 403 | application/json |
errors.ResourceNotFound | 404 | application/json |
errors.HTTPValidationError | 422 | application/json |
errors.SDKError | 4xx-5xx | / |
Cancel a subscription.
import { Polar } from "@polar-sh/sdk";
const polar = new Polar({
accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
});
async function run() {
const result = await polar.users.subscriptions.cancel({
id: "<value>",
});
// Handle the result
console.log(result)
}
run();
The standalone function version of this method:
import { PolarCore } from "@polar-sh/sdk/core.js";
import { usersSubscriptionsCancel } from "@polar-sh/sdk/funcs/usersSubscriptionsCancel.js";
// Use `PolarCore` for best tree-shaking performance.
// You can create one instance of it to use across an application.
const polar = new PolarCore({
accessToken: process.env["POLAR_ACCESS_TOKEN"] ?? "",
});
async function run() {
const res = await usersSubscriptionsCancel(polar, {
id: "<value>",
});
if (!res.ok) {
throw res.error;
}
const { value: result } = res;
// Handle the result
console.log(result)
}
run();
Parameter | Type | Required | Description |
---|---|---|---|
request |
operations.UsersSubscriptionsCancelRequest | ✔️ | The request object to use for the request. |
options |
RequestOptions | ➖ | Used to set various options for making HTTP requests. |
options.fetchOptions |
RequestInit | ➖ | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All Request options, except method and body , are allowed. |
options.retries |
RetryConfig | ➖ | Enables retrying HTTP requests under certain failure conditions. |
Promise<components.UserSubscription>
Error Object | Status Code | Content Type |
---|---|---|
errors.AlreadyCanceledSubscription | 403 | application/json |
errors.ResourceNotFound | 404 | application/json |
errors.HTTPValidationError | 422 | application/json |
errors.SDKError | 4xx-5xx | / |