Polar Integration

Polar API Operations

Browse all 166 operations available for Polar workflow automation.

Benefit-grants

1 operation
GET/v1/benefit-grants/

List Benefit Grants

View all the benefits you've granted to customers and supporters across your organization, helping you track who has access to what benefits.

7 query params

Benefits

6 operations
POST/v1/benefits/

Create Benefit

Create a new benefit offering that you can attach to products or subscriptions to provide exclusive perks and value to your customers.

DELETE/v1/benefits/{id}

Delete Benefit

Permanently removes a benefit offering from your Polar account, which automatically revokes access for all users who previously received it.

1 path params
GET/v1/benefits/{id}

Get Benefit

Retrieve the details of a specific benefit you've created, including its description, features, and associated products or tiers.

1 path params
GET/v1/benefits/{id}/grants

List Benefit Grants

Retrieve all individual grants for a specific benefit to verify which users have access to it. Use this to audit benefit distribution and manage user entitlements across your membership or subscription program.

1 path, 5 query params
GET/v1/benefits/

List Benefits

Retrieve all benefits you've created for your products or services to view their names, descriptions, and availability status in one place.

9 query params
PATCH/v1/benefits/{id}

Update Benefit

Modify the details of an existing benefit such as its name, description, or availability settings to keep your offerings current and aligned with your business goals.

1 path params

Checkouts

7 operations
POST/v1/checkouts/client/{client_secret}/confirm

Confirm Checkout Session from Client

Complete a checkout session using the client secret to process orders and subscriptions on your storefront or custom checkout page.

1 path params
POST/v1/checkouts/

Create Checkout Session

Set up a checkout session to collect payments from customers for your products or services. This creates a secure payment flow that handles transaction processing and customer data.

GET/v1/checkouts/{id}

Get Checkout Session

Retrieve the details of a specific checkout session to view payment status, customer information, and transaction data.

1 path params
GET/v1/checkouts/client/{client_secret}

Get Checkout Session from Client

Retrieve checkout session details using a client secret to verify payment status and session information after a customer initiates a purchase.

1 path params
GET/v1/checkouts/

List Checkout Sessions

Retrieve all checkout sessions created for your products and subscriptions, allowing you to view and analyze customer purchase activity and conversion data.

9 query params
PATCH/v1/checkouts/{id}

Update Checkout Session

Modify an existing checkout session to update pricing, discount codes, customer information, or other session details before the customer completes their purchase.

1 path params
PATCH/v1/checkouts/client/{client_secret}

Update Checkout Session from Client

Modify an active checkout session using the client secret to update customer information, prices, or product selections before payment is completed.

1 path params

Custom-fields

5 operations
POST/v1/custom-fields/

Create Custom Field

Add a custom field to your Polar workspace to capture and store additional information that matters to your business beyond standard data fields.

DELETE/v1/custom-fields/{id}

Delete Custom Field

Remove a custom field from your Polar workspace when it's no longer needed, immediately stopping its use across all associated records and workflows.

1 path params
GET/v1/custom-fields/{id}

Get Custom Field

Retrieve the details and configuration of a specific custom field you've set up in your Polar workspace. Use this to access field properties like name, type, and settings without listing all custom fields.

1 path params
GET/v1/custom-fields/

List Custom Fields

Retrieve all custom fields available in your Polar workspace to understand what additional information you can collect from customers and donors. This helps you see your entire data collection setup at a glance.

6 query params
PATCH/v1/custom-fields/{id}

Update Custom Field

Modify the settings and configuration of an existing custom field to keep your customer data structure aligned with your business needs.

1 path params

Customer-seats

6 operations
POST/v1/customer-seats

Assign Seat

Allocates a customer seat license to enable a user to access your product or service within their subscription. Use this when you need to grant access to a specific team member or collaborator.

POST/v1/customer-seats/claim

Claim Seat

Assign a subscription seat to a customer, enabling them to access your product or service as part of their subscription tier. This is essential for managing who has active access within a subscription.

GET/v1/customer-seats/claim/{invitation_token}

Get Claim Info

Retrieve details about a customer seat claim using an invitation token, allowing you to verify claim status and user information before completing the seat assignment.

1 path params
GET/v1/customer-seats

List Seats

Retrieves a list of all customer seats or licenses you've assigned to your customers, allowing you to track who has access to your product and their current status.

2 query params
POST/v1/customer-seats/{seat_id}/resend

Resend Invitation

Resend a seat invitation to a customer who hasn't yet accepted their access. Use this when an invitation email may have been missed, deleted, or needs to be sent to a customer again.

1 path params
DELETE/v1/customer-seats/{seat_id}

Revoke Seat

Remove a team member's access to your Polar account by revoking their assigned seat. This frees up that seat license for another team member or reduces your subscription costs.

1 path params

Customer-sessions

1 operation
POST/v1/customer-sessions/

Create Customer Session

Establishes a secure session for a customer to access their account or content, enabling authenticated interactions with your platform. This allows you to manage customer access and track their engagement with your products or services.

Customer_meters

2 operations
GET/v1/customer-meters/{id}

Get Customer Meter

Retrieve detailed information about a specific customer's usage meter, including current consumption data and metrics tracked for billing or service delivery purposes.

1 path params
GET/v1/customer-meters/

List Customer Meters

Retrieve all metered usage records for your customers to monitor consumption patterns and track their product usage over time. This helps you understand customer engagement and usage trends for billing or analytics purposes.

7 query params

Customer_portal

38 operations
POST/v1/customer-portal/license-keys/activate

Activate License Key

Enables customers to activate their license keys directly from your application or website, allowing them to unlock premium features or extend their access. This is ideal for self-service activations in client-side applications where you want customers to manage their own licenses.

POST/v1/customer-portal/customers/me/payment-methods

Add Customer Payment Method

Allows customers to securely add a new payment method (credit card, bank account, etc.) to their account for future transactions and subscriptions.

customer_portal:write
POST/v1/customer-portal/seats

Assign Seat

Allocate a subscription seat to a team member or customer, enabling them to access your product or service with their own credentials and usage tracking.

customer_portal:write
DELETE/v1/customer-portal/subscriptions/{id}

Cancel Subscription

Allows you to cancel an active subscription for your customer through your customer portal, immediately stopping future billing and access.

customer_portal:write
1 path params
POST/v1/customer-portal/customers/me/payment-methods/confirm

Confirm Customer Payment Method

Verify that a customer's payment method (such as a credit card) is valid and working before processing charges. This ensures you can reliably collect payments from your customers.

customer_portal:write
POST/v1/customer-portal/orders/{id}/confirm-payment

Confirm Retry Payment

Complete a payment retry for a customer order by confirming their Stripe payment details, allowing them to resolve failed transactions without having to re-enter their information.

customer_portal:write
1 path params
POST/v1/customer-portal/license-keys/deactivate

Deactivate License Key

Allows customers to disable an active license key from your application without needing to log in, making it easy to manage their licenses from desktop or mobile clients.

DELETE/v1/customer-portal/customers/me/payment-methods/{id}

Delete Customer Payment Method

Remove a payment method from your customer account, allowing you to delete outdated or unused payment information.

customer_portal:write
1 path params
POST/v1/customer-portal/orders/{id}/invoice

Generate Order Invoice

Creates and generates an invoice document for a specific customer order, making it available for download or sharing with customers.

customer_portal:readcustomer_portal:write
1 path params
GET/v1/customer-portal/customer-session/user

Get Authenticated Portal User

Retrieve details about the customer who is currently logged into your customer portal, including their profile information and account status.

customer_portal:readcustomer_portal:write
GET/v1/customer-portal/benefit-grants/{id}

Get Benefit Grant

Retrieve the details of a specific benefit grant that belongs to the authenticated customer, including its status and terms.

customer_portal:readcustomer_portal:write
1 path params
GET/v1/customer-portal/customers/me

Get Customer

Retrieves the authenticated customer's profile information including account details, subscription status, and personal data from Polar. This helps you access and verify customer account information whenever needed.

customer_portal:readcustomer_portal:write
GET/v1/customer-portal/meters/{id}

Get Customer Meter

Retrieve detailed information about a specific usage meter associated with your account, allowing you to track and monitor billing metrics in real-time.

customer_portal:readcustomer_portal:write
1 path params
GET/v1/customer-portal/license-keys/{id}

Get License Key

Retrieve the details of a specific license key, including its activation status, expiration date, and associated product information. Use this to verify customer licenses and manage access to your protected software or services.

customer_portal:readcustomer_portal:write
1 path params
GET/v1/customer-portal/orders/{id}

Get Order

Retrieve detailed information about a specific customer order, including items, pricing, and status. This helps you look up order details to respond to customer inquiries or verify transaction information.

customer_portal:readcustomer_portal:write
1 path params
GET/v1/customer-portal/orders/{id}/invoice

Get Order Invoice

Retrieve the invoice details for a specific customer order, including amounts, items, and payment information for record-keeping or customer communication.

customer_portal:readcustomer_portal:write
1 path params
GET/v1/customer-portal/orders/{id}/payment-status

Get Order Payment Status

Check the current payment status of a customer's order to see if payment has been received, is pending, or has failed. This helps you track transaction completion and take appropriate follow-up actions.

customer_portal:readcustomer_portal:write
1 path params
GET/v1/customer-portal/organizations/{slug}

Get Organization

Retrieves detailed information about your organization using its unique slug identifier, including branding, settings, and configuration details that appear on your customer portal.

1 path params
GET/v1/customer-portal/subscriptions/{id}

Get Subscription

Retrieve detailed information about a specific customer subscription, including its status, billing cycle, and plan details. This helps you understand what products or services a customer currently has active.

customer_portal:readcustomer_portal:write
1 path params
GET/v1/customer-portal/wallets/{id}

Get Wallet

Retrieve detailed information about a specific wallet belonging to an authenticated customer, including balance and transaction history. This helps you monitor customer funds and payment status in real-time.

customer_portal:readcustomer_portal:write
1 path params
GET/v1/customer-portal/customer-session/introspect

Introspect Customer Session

Retrieve information about the current customer session to understand who is logged in and their status. This helps you verify session validity and access customer details without requiring a new login.

customer_portal:readcustomer_portal:write
GET/v1/customer-portal/benefit-grants/

List Benefit Grants

Retrieve all benefits and grants that your customers have earned or are eligible for through their account. This helps you understand what perks and rewards your paying customers currently have access to.

customer_portal:readcustomer_portal:write
9 query params
GET/v1/customer-portal/seats/subscriptions

List Claimed Subscriptions

Retrieve all subscriptions where the authenticated customer currently has an active claimed seat, allowing you to see which products or services you're entitled to use.

customer_portal:readcustomer_portal:write
GET/v1/customer-portal/customers/me/payment-methods

List Customer Payment Methods

Retrieve all saved payment methods for the authenticated customer, allowing you to see what cards or payment options are on file for streamlined transactions.

customer_portal:readcustomer_portal:write
2 query params
GET/v1/customer-portal/downloadables/

List Downloadables

Retrieves a list of downloadable files and resources available to customers through the customer portal, such as guides, templates, or product files. Use this to display or manage the digital assets your customers can access.

customer_portal:readcustomer_portal:write
3 query params
GET/v1/customer-portal/license-keys/

List License Keys

Retrieve all license keys associated with a customer account, allowing you to view and manage software licenses tied to their purchases or subscriptions.

customer_portal:readcustomer_portal:write
3 query params
GET/v1/customer-portal/meters/

List Meters

Retrieve all usage meters tracked for your customer account, allowing you to monitor consumption metrics and billing data in real-time.

customer_portal:readcustomer_portal:write
5 query params
GET/v1/customer-portal/orders/

List Orders

Retrieve a complete list of all orders placed by a customer, allowing you to display purchase history and order details in your customer portal or dashboard.

customer_portal:readcustomer_portal:write
7 query params
GET/v1/customer-portal/seats

List Seats

Retrieves a list of all seats associated with your subscription, showing which team members have access and their current status. Use this to manage your team's subscription allocations and monitor seat usage.

customer_portal:readcustomer_portal:write
2 query params
GET/v1/customer-portal/subscriptions/

List Subscriptions

Retrieve all active and past subscriptions for your authenticated customer account, allowing you to manage and track their subscription history in your system.

customer_portal:readcustomer_portal:write
6 query params
GET/v1/customer-portal/wallets/

List Wallets

Retrieve all cryptocurrency wallets connected to a customer account, allowing visibility into all stored digital assets and their balances.

customer_portal:readcustomer_portal:write
3 query params
POST/v1/customer-portal/seats/{seat_id}/resend

Resend Invitation

Sends a new invitation link to a team member who hasn't yet accepted their seat, allowing them to join your organization without needing to create a new seat.

customer_portal:write
1 path params
DELETE/v1/customer-portal/seats/{seat_id}

Revoke Seat

Remove access for a specific team member or user from your organization's account and resources. This immediately revokes their seat license and prevents them from accessing any shared content or collaboration features.

customer_portal:write
1 path params
PATCH/v1/customer-portal/benefit-grants/{id}

Update Benefit Grant

Modify the details of a benefit grant that's been issued to a customer, such as updating expiration dates or redemption terms. This lets you adjust customer benefits as circumstances change without recreating the entire grant.

customer_portal:write
1 path params
PATCH/v1/customer-portal/customers/me

Update Customer

Modify your customer profile information such as name, email, or billing details directly through the customer portal. This lets you keep your account details current without contacting support.

customer_portal:write
PATCH/v1/customer-portal/orders/{id}

Update Order

Modify the details of an existing order in your customer portal, such as updating quantities, shipping information, or other order specifics for your customers.

customer_portal:write
1 path params
PATCH/v1/customer-portal/subscriptions/{id}

Update Subscription

Modify an existing customer subscription to change plans, update billing details, or adjust subscription settings. This lets you help customers manage their own subscriptions without manual intervention.

customer_portal:write
1 path params
POST/v1/customer-portal/license-keys/validate

Validate License Key

Verify that a license key is valid and active without exposing sensitive server credentials, making it ideal for client-side validation in desktop or mobile applications.

Customers

11 operations
POST/v1/customers/

Create Customer

Register a new customer in your Polar account to start tracking their purchases and managing their subscription lifecycle. This enables you to organize customer data and understand your revenue streams.

DELETE/v1/customers/{id}

Delete Customer

Permanently removes a customer account and cancels all their active subscriptions and benefits in one action. Use this when a customer requests deletion or you need to remove a user from your service.

1 path, 1 query params
DELETE/v1/customers/external/{external_id}

Delete Customer by External ID

Removes a customer from your system and immediately cancels their active subscriptions and benefits. Use the anonymize option to comply with data privacy regulations by removing personally identifiable information.

1 path, 1 query params
GET/v1/customers/export

Export Customers

Download your complete customer list as a CSV file for analysis, reporting, or integration with other business tools.

1 query params
GET/v1/customers/{id}

Get Customer

Retrieve detailed information about a specific customer by their ID, including their profile data, subscription status, and purchase history. Use this to access customer details for support, fulfillment, or personalization purposes.

1 path params
GET/v1/customers/{id}/state

Get Customer State

Retrieve a customer's current status including their active subscriptions and benefits to get a complete overview of their account. Use this to make informed decisions about customer engagement, support, or service delivery.

1 path params
GET/v1/customers/external/{external_id}/state

Get Customer State by External ID

Retrieve a customer's current subscription status and active benefits using their external ID, giving you a complete snapshot of their relationship with your business.

1 path params
GET/v1/customers/external/{external_id}

Get Customer by External ID

Retrieve a customer's profile and details using an external identifier you've assigned, such as a customer ID from your own system or third-party platform. This helps you quickly access customer information without needing to search by email or internal Polar ID.

1 path params
GET/v1/customers/

List Customers

Retrieve a list of all your customers to view their profiles, purchase history, and subscription status in one place.

7 query params
PATCH/v1/customers/{id}

Update Customer

Modify customer information such as name, email, or metadata to keep your customer records accurate and up-to-date. This ensures your customer data reflects the latest information for better communication and record-keeping.

1 path params
PATCH/v1/customers/external/{external_id}

Update Customer by External ID

Modify customer information using an external identifier you've assigned, allowing you to keep your customer records in sync across systems without managing Polar's internal IDs.

1 path params

Discounts

5 operations
POST/v1/discounts/

Create Discount

Create a discount code or promotional offer for your products or subscriptions, allowing you to set specific discount amounts, percentages, or usage limits.

DELETE/v1/discounts/{id}

Delete Discount

Remove a discount code from your store when it's no longer needed or has expired. This permanently deletes the discount so customers can no longer apply it at checkout.

1 path params
GET/v1/discounts/{id}

Get Discount

Retrieve detailed information about a specific discount including its terms, usage limits, and redemption status.

1 path params
GET/v1/discounts/

List Discounts

Retrieve all discounts you've created to view their details, usage status, and current settings. This helps you manage promotional offers and track which discounts are active across your products.

5 query params
PATCH/v1/discounts/{id}

Update Discount

Modify an existing discount's details such as code, percentage, duration, or applicable products to keep your promotional offers current and effective.

1 path params

Disputes

2 operations
GET/v1/disputes/{id}

Get Dispute

Retrieve detailed information about a specific dispute, including its status, reason, and timeline, so you can track and manage customer payment issues or chargeback claims.

1 path params
GET/v1/disputes/

List Disputes

Retrieve a complete list of all disputes associated with your Polar account to monitor payment conflicts and customer issues.

6 query params

Event-types

2 operations
GET/v1/event-types/

List Event Types

Retrieve all available event types with aggregated statistics to understand what events are tracked in your account. This helps you identify which events are most important to your business and how they're performing.

10 query params
PATCH/v1/event-types/{id}

Update Event Type

Modify the label and details of an existing event type to keep your scheduling options current and aligned with your business needs.

1 path params

Events

4 operations
GET/v1/events/{id}

Get Event

Retrieve detailed information about a specific event using its ID, including event details, metadata, and associated data. This helps you access event information programmatically for display, integration, or management purposes.

1 path params
POST/v1/events/ingest

Ingest Events

Send multiple events to Polar in a single batch request, enabling you to record customer actions, subscriptions, or transactions efficiently without making individual API calls.

GET/v1/events/names

List Event Names

Retrieve a list of all available event types in your Polar account so you can understand what events are being tracked and triggered by your products or services.

8 query params
GET/v1/events/

List Events

Retrieve a list of all events from your Polar account to view, filter, and manage your community activities and customer engagement records.

16 query params

Files

5 operations
POST/v1/files/{id}/uploaded

Complete File Upload

Notify the system that a file has finished uploading so it can be processed and made available for use in your application or workflow.

1 path params
POST/v1/files/

Create File

Upload and store files in your Polar account to organize digital assets, documents, or resources for your products and customers. This enables you to centralize file management and make content easily accessible across your business operations.

DELETE/v1/files/{id}

Delete File

Permanently removes a file from your Polar account, freeing up storage space and ensuring outdated or sensitive content is no longer accessible.

1 path params
GET/v1/files/

List Files

Retrieve all files you've uploaded to your Polar account so you can organize, track, and manage your digital assets in one place.

4 query params
PATCH/v1/files/{id}

Update File

Modify an existing file's properties such as name, description, or metadata to keep your file organization up-to-date without replacing the entire file.

1 path params

License_keys

7 operations
POST/v1/license-keys/activate

Activate License Key

Enables a license key so customers can start using your software product or service. This is essential when you're ready to grant access to a new customer after they've completed purchase or setup.

POST/v1/license-keys/deactivate

Deactivate License Key

Disable an active license key to prevent further use without permanently deleting it, useful for managing access when customers cancel or when you need to revoke permissions temporarily.

GET/v1/license-keys/{id}/activations/{activation_id}

Get Activation

Retrieve detailed information about a specific license activation, including its status, activation date, and associated device details.

2 path params
GET/v1/license-keys/{id}

Get License Key

Retrieve details of a specific license key, including its status, expiration date, and usage information to verify activation and entitlement status.

1 path params
GET/v1/license-keys/

List License Keys

Retrieve all license keys associated with your organization, optionally filtered by specific criteria to find particular licenses or activation statuses. This helps you manage and monitor which licenses are active, inactive, or assigned to specific customers.

4 query params
PATCH/v1/license-keys/{id}

Update License Key

Modify an existing license key's settings, such as expiration date, limits, or activation status, to manage your software licensing without creating a new key.

1 path params
POST/v1/license-keys/validate

Validate License Key

Verifies whether a license key is valid and active, allowing you to check customer licenses in real-time before granting access to your product or service.

Member-sessions

1 operation
POST/v1/member-sessions/

Create Member Session

Initiates a new member session for organizations using seat-based pricing, enabling you to track and manage individual member access and activity.

Members

5 operations
POST/v1/members/

Create Member

Add a new team member to a customer account so they can access and collaborate within your platform.

DELETE/v1/members/{id}

Delete Member

Remove a member from your organization, immediately revoking their access to all team resources and collaborative features.

1 path params
GET/v1/members/{id}

Get Member

Retrieve detailed information about a specific member in your organization by their ID. Use this to access member profiles, contact details, and membership status for individual team members or customers.

1 path params
GET/v1/members/

List Members

Retrieve a list of all members in your Polar account, with optional filtering by customer ID to find specific members. Use this to view, analyze, and manage your community or subscriber base.

5 query params
PATCH/v1/members/{id}

Update Member

Modify a team member's name or role within your organization to keep your team structure current and reflect changing responsibilities.

1 path params

Meters

5 operations
POST/v1/meters/

Create Meter

Set up a new meter to track and measure specific metrics or usage events in your business, such as API calls, feature usage, or customer activity.

GET/v1/meters/{id}

Get Meter

Retrieve detailed information about a specific meter, including its current readings and configuration details. This helps you monitor and track individual meter performance in your system.

1 path params
GET/v1/meters/{id}/quantities

Get Meter Quantities

Retrieve the quantity measurements for a specific meter over a defined time period to track consumption, usage, or production metrics.

1 path, 7 query params
GET/v1/meters/

List Meters

Retrieve all meters configured in your account to view and manage your usage tracking metrics. This helps you monitor what you're measuring and ensure all your key metrics are properly set up.

7 query params
PATCH/v1/meters/{id}

Update Meter

Modify the configuration and settings of an existing meter to track usage metrics in real-time. Use this to adjust billing thresholds, update tracking parameters, or change how you measure customer consumption.

1 path params

Metrics

2 operations
GET/v1/metrics/

Get Metrics

Retrieve metrics data about your orders and subscriptions to monitor sales performance and revenue trends. Use this to track key business metrics across your products and understand customer purchase patterns.

9 query params
GET/v1/metrics/limits

Get Metrics Limits

Check the rate limits and data refresh intervals for your metrics API requests so you can plan your data collection and avoid hitting usage caps.

Oauth2

9 operations
GET/v1/oauth2/authorize

Authorize

Initiates the authorization flow to securely connect your application with Polar, allowing users to grant access to their account information and perform actions on their behalf.

POST/v1/oauth2/register

Create Client

Register a new OAuth2 application to enable secure third-party integrations with your Polar account. This allows other apps and services to request permission to access your data on your behalf.

DELETE/v1/oauth2/register/{client_id}

Delete Client

Remove an OAuth2 client registration from your Polar account when you no longer need an application to access your data. This is useful for cleaning up old integrations or revoking access from third-party tools.

1 path params
GET/v1/oauth2/register/{client_id}

Get Client

Retrieve the details of an OAuth2 application you've registered, including its configuration and credentials.

1 path params
GET/v1/oauth2/userinfo

Get User Info

Retrieves the profile information of the currently authenticated user, including their name, email, and account details.

POST/v1/oauth2/introspect

Introspect Token

Verify the validity and details of an access token to ensure it's active and retrieve its associated user or application information.

POST/v1/oauth2/token

Request Token

Exchange your authorization credentials for an access token that allows your application to interact with the Polar API on behalf of your account. This is the essential first step in authenticating your integration.

POST/v1/oauth2/revoke

Revoke Token

Invalidates an access token or refresh token to immediately revoke a user's access to your application. Use this when you need to disconnect a user's account or end their session.

PUT/v1/oauth2/register/{client_id}

Update Client

Modify the settings and configuration of an existing OAuth2 application, such as updating redirect URLs, display names, or access permissions without creating a new app.

1 path params

Orders

6 operations
GET/v1/orders/export

Export Subscriptions

Download your subscription orders as a CSV file for analysis, reporting, or import into other business tools.

2 query params
POST/v1/orders/{id}/invoice

Generate Order Invoice

Generate a formal invoice document for a customer order that can be downloaded, shared, or stored for accounting and record-keeping purposes.

1 path params
GET/v1/orders/{id}

Get Order

Retrieve detailed information about a specific order using its ID, including customer details, items purchased, and payment status. This helps you quickly access and review individual transaction records.

1 path params
GET/v1/orders/{id}/invoice

Get Order Invoice

Retrieve the invoice details for a specific order, including amounts, items, and customer information for record-keeping and financial tracking.

1 path params
GET/v1/orders/

List Orders

Retrieve a list of all orders placed by customers, allowing you to view transaction history and monitor sales activity in one place.

11 query params
PATCH/v1/orders/{id}

Update Order

Modify order details such as customer information, items, pricing, or status after an order has been created, allowing you to correct errors or adjust orders based on customer requests.

1 path params

Organization_access_tokens

4 operations
POST/v1/organization-access-tokens/

Create

Generate secure access tokens for programmatic interactions with your organization's Polar account, enabling automated workflows and integrations without exposing your main credentials.

DELETE/v1/organization-access-tokens/{id}

Delete

Remove an access token from your organization to revoke API access for integrations or applications that are no longer needed or have been compromised.

1 path params
GET/v1/organization-access-tokens/

List

Retrieve all access tokens created for your organization to manage API authentication and integrations. Use this to audit which tokens exist, track their creation dates, and identify active authentication methods.

4 query params
PATCH/v1/organization-access-tokens/{id}

Update

Modify an existing organization access token's settings, such as expiration date or permissions scope. Use this to update security credentials without needing to create new tokens.

1 path params

Organizations

4 operations
POST/v1/organizations/

Create Organization

Set up a new organization to manage your products, subscriptions, and team members in one centralized workspace.

GET/v1/organizations/{id}

Get Organization

Retrieve detailed information about a specific organization using its unique identifier, such as name, settings, and profile details.

1 path params
GET/v1/organizations/

List Organizations

Retrieve a list of all organizations you manage or belong to, helping you quickly access organization details and settings across your business accounts.

4 query params
PATCH/v1/organizations/{id}

Update Organization

Modify your organization's details such as name, settings, and profile information to keep your business information current and accurate.

1 path params

Payments

2 operations
GET/v1/payments/{id}

Get Payment

Retrieve detailed information about a specific payment transaction by its ID, including payment status, amount, and customer details. This allows you to verify payment details and track transaction history.

1 path params
GET/v1/payments/

List Payments

Retrieve a list of all payments received from your customers, allowing you to view transaction history and track incoming revenue. This helps you understand your cash flow and verify that payments have been successfully processed.

9 query params

Products

5 operations
POST/v1/products/

Create Product

Add a new product to your Polar store that customers can purchase, download, or subscribe to. This lets you list your digital offerings and start generating revenue.

GET/v1/products/{id}

Get Product

Retrieve detailed information about a specific product by its ID, including pricing, description, and inventory details. This helps you access product data for display, verification, or integration with other business systems.

1 path params
GET/v1/products/

List Products

Retrieve all products you've created in your Polar store, including details about pricing, inventory, and availability to manage your product catalog.

10 query params
PATCH/v1/products/{id}

Update Product

Modify an existing product's details such as name, description, pricing, or status to keep your offering current and aligned with your business needs.

1 path params
POST/v1/products/{id}/benefits

Update Product Benefits

Modify the perks, features, or benefits that customers receive when they purchase a product, such as access to exclusive content, support tiers, or digital resources.

1 path params

Refunds

2 operations
POST/v1/refunds/

Create Refund

Issue a refund for a customer purchase, allowing you to return funds for orders or subscriptions that need to be reversed.

GET/v1/refunds/

List Refunds

Retrieve all refunds issued in your Polar account to see transaction reversals and refund activity over time. Use this to track customer refunds, monitor refund patterns, and reconcile your refund records.

10 query params

Subscriptions

6 operations
POST/v1/subscriptions/

Create Subscription

Programmatically create subscriptions for free products in your Polar store without triggering checkout flows or confirmation emails. Use this when you need to set up subscriber relationships directly through your own application or system.

GET/v1/subscriptions/export

Export Subscriptions

Download all your subscription data in CSV format for analysis, reporting, or integration with other business tools. This allows you to easily access and manage your customer subscription information outside of Polar.

1 query params
GET/v1/subscriptions/{id}

Get Subscription

Retrieve detailed information about a specific subscription including its status, pricing, and customer details. Use this to check subscription health and manage your revenue-generating customers.

1 path params
GET/v1/subscriptions/

List Subscriptions

Retrieve a list of all subscriptions associated with your products, showing active and inactive customer subscriptions. This helps you track recurring revenue and monitor customer subscription status.

11 query params
DELETE/v1/subscriptions/{id}

Revoke Subscription

Immediately cancel a customer's active subscription, preventing further charges and access. Use this when a customer requests cancellation or you need to terminate their service right away.

1 path params
PATCH/v1/subscriptions/{id}

Update Subscription

Modify subscription details such as billing cycle, amount, or status to adapt to changing customer needs without interrupting service.

1 path params

Webhooks

8 operations
POST/v1/webhooks/endpoints

Create Webhook Endpoint

Register a new webhook endpoint to receive real-time notifications about events in your Polar account, such as new subscriptions or payment updates. This allows you to automatically trigger actions in other tools and systems without manual intervention.

DELETE/v1/webhooks/endpoints/{id}

Delete Webhook Endpoint

Remove a webhook endpoint from your Polar account when you no longer need to receive real-time notifications about events like new subscriptions or updates.

1 path params
GET/v1/webhooks/endpoints/{id}

Get Webhook Endpoint

Retrieves the configuration details of a specific webhook endpoint to view its settings, URL, and event subscriptions. This helps you verify or audit your webhook integrations with Polar.

1 path params
GET/v1/webhooks/deliveries

List Webhook Deliveries

View all attempts to deliver webhook events to your endpoints, helping you track which notifications were successfully sent and identify any delivery failures.

9 query params
GET/v1/webhooks/endpoints

List Webhook Endpoints

View all webhook endpoints you've configured to receive real-time notifications about events in your Polar account. This helps you manage and monitor which systems are connected to receive updates about subscriptions, payments, and other important activities.

3 query params
POST/v1/webhooks/events/{id}/redeliver

Redeliver Webhook Event

Triggers a retry of a previously failed webhook event, allowing you to recover from temporary delivery issues without manually recreating the original event.

1 path params
PATCH/v1/webhooks/endpoints/{id}/secret

Reset Webhook Endpoint Secret

Regenerate the secret key used to verify webhook authenticity from Polar, useful when the current secret may have been compromised or exposed.

1 path params
PATCH/v1/webhooks/endpoints/{id}

Update Webhook Endpoint

Modify an existing webhook endpoint's configuration, such as URL, event types, or active status, to ensure your integrations stay aligned with your current business needs.

1 path params