{"openapi":"3.0.0","info":{"description":"Polar.sh API for managing products, prices, checkout, orders, subscriptions, benefits, webhooks, customers, and organizations","version":[{"name":"v1","value":"v1"}]},"servers":[{"description":"Polar.sh API for managing products, prices, checkout, orders, subscriptions, benefits, webhooks, customers, and organizations","url":"https://api.apirails.com/polarsh"}],"paths":{"/products":{"get":{"tags":["Products"],"parameters":[{"name":"limit","in":"query","description":"Number of items to return per page (window size), max 100","schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number, starting from 1","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/products/list","api_endpoint":"https://api.polar.sh/v1/products"},"summary":"List products","description":"List all products in your organization","security":[{"bearerAuth":[]}]},"post":{"tags":["Products"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/products/create","api_endpoint":"https://api.polar.sh/v1/products"},"summary":"Create product","description":"Create a new product","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description":{"type":"string","description":"Product description"},"metadata":{"type":"object","description":"Additional metadata for the product","properties":{}},"name":{"type":"string","description":"Product name","required":true}}},"example":{"description":"","metadata":{},"name":""}}}}}},"/products/{product_id}":{"get":{"tags":["Products"],"parameters":[{"name":"product_id","in":"path","description":"Product ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/products/get","api_endpoint":"https://api.polar.sh/v1/products/{product_id}"},"summary":"Get product","description":"Get a specific product by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Products"],"parameters":[{"name":"product_id","in":"path","description":"Product ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/products/update","api_endpoint":"https://api.polar.sh/v1/products/{product_id}"},"summary":"Update product","description":"Update a product","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description":{"type":"string","description":"Product description"},"metadata":{"type":"object","description":"Additional metadata for the product","properties":{}},"name":{"type":"string","description":"Product name"}}},"example":{"description":"","metadata":{},"name":""}}}}},"delete":{"tags":["Products"],"parameters":[{"name":"product_id","in":"path","description":"Product ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/products/delete","api_endpoint":"https://api.polar.sh/v1/products/{product_id}"},"summary":"Delete product","description":"Delete a product","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/prices":{"get":{"tags":["Prices"],"parameters":[{"name":"limit","in":"query","description":"Number of items to return per page (window size), max 100","schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number, starting from 1","schema":{"type":"number","example":""}},{"name":"product_id","in":"query","description":"Filter prices by product ID","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/prices/list","api_endpoint":"https://api.polar.sh/v1/prices"},"summary":"List prices","description":"List all prices","security":[{"bearerAuth":[]}]},"post":{"tags":["Prices"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/prices/create","api_endpoint":"https://api.polar.sh/v1/prices"},"summary":"Create price","description":"Create a new price","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"amount":{"type":"number","description":"Price amount in cents","required":true},"currency":{"type":"string","description":"Currency code (e.g., USD, EUR)","required":true},"metadata":{"type":"object","description":"Additional metadata for the price","properties":{}},"product_id":{"type":"string","description":"Product ID","required":true},"recurring":{"type":"object","description":"Recurring pricing configuration","properties":{}}}},"example":{"amount":"","currency":"","metadata":{},"product_id":"","recurring":{}}}}}}},"/prices/{price_id}":{"get":{"tags":["Prices"],"parameters":[{"name":"price_id","in":"path","description":"Price ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/prices/get","api_endpoint":"https://api.polar.sh/v1/prices/{price_id}"},"summary":"Get price","description":"Get a specific price by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Prices"],"parameters":[{"name":"price_id","in":"path","description":"Price ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/prices/update","api_endpoint":"https://api.polar.sh/v1/prices/{price_id}"},"summary":"Update price","description":"Update a price","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"metadata":{"type":"object","description":"Additional metadata for the price","properties":{}}}},"example":{"metadata":{}}}}}},"delete":{"tags":["Prices"],"parameters":[{"name":"price_id","in":"path","description":"Price ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/prices/delete","api_endpoint":"https://api.polar.sh/v1/prices/{price_id}"},"summary":"Delete price","description":"Delete a price","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/checkouts":{"post":{"tags":["Checkout"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/checkout/create","api_endpoint":"https://api.polar.sh/v1/checkouts"},"summary":"Create checkout","description":"Create a new checkout session","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"customer_email":{"type":"string","description":"Customer email address"},"external_customer_id":{"type":"string","description":"External customer ID"},"metadata":{"type":"object","description":"Additional metadata for the checkout","properties":{}},"price_id":{"type":"string","description":"Price ID","required":true},"product_id":{"type":"string","description":"Product ID","required":true},"success_url":{"type":"string","description":"URL to redirect to after successful checkout"}}},"example":{"customer_email":"","external_customer_id":"","metadata":{},"price_id":"","product_id":"","success_url":""}}}}}},"/checkouts/{checkout_id}":{"get":{"tags":["Checkout"],"parameters":[{"name":"checkout_id","in":"path","description":"Checkout ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/checkout/get","api_endpoint":"https://api.polar.sh/v1/checkouts/{checkout_id}"},"summary":"Get checkout","description":"Get a specific checkout by ID","security":[{"bearerAuth":[]}]}},"/orders":{"get":{"tags":["Orders"],"parameters":[{"name":"customer_id","in":"query","description":"Filter orders by customer ID","schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"Number of items to return per page (window size), max 100","schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number, starting from 1","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/orders/list","api_endpoint":"https://api.polar.sh/v1/orders"},"summary":"List orders","description":"List all orders","security":[{"bearerAuth":[]}]}},"/orders/{order_id}":{"get":{"tags":["Orders"],"parameters":[{"name":"order_id","in":"path","description":"Order ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/orders/get","api_endpoint":"https://api.polar.sh/v1/orders/{order_id}"},"summary":"Get order","description":"Get a specific order by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Orders"],"parameters":[{"name":"order_id","in":"path","description":"Order ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/orders/update","api_endpoint":"https://api.polar.sh/v1/orders/{order_id}"},"summary":"Update order","description":"Update an order","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"metadata":{"type":"object","description":"Additional metadata for the order","properties":{}}}},"example":{"metadata":{}}}}}}},"/orders/{order_id}/invoice":{"post":{"tags":["Orders"],"parameters":[{"name":"order_id","in":"path","description":"Order ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/orders/invoice","api_endpoint":"https://api.polar.sh/v1/orders/{order_id}/invoice"},"summary":"Generate order invoice","description":"Generate an invoice for an order","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"billing_address":{"type":"object","description":"Billing address for the invoice","properties":{}}}},"example":{"billing_address":{}}}}}}},"/subscriptions":{"get":{"tags":["Subscriptions"],"parameters":[{"name":"customer_id","in":"query","description":"Filter subscriptions by customer ID","schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"Number of items to return per page (window size), max 100","schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number, starting from 1","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/subscriptions/list","api_endpoint":"https://api.polar.sh/v1/subscriptions"},"summary":"List subscriptions","description":"List all subscriptions","security":[{"bearerAuth":[]}]}},"/subscriptions/{subscription_id}":{"get":{"tags":["Subscriptions"],"parameters":[{"name":"subscription_id","in":"path","description":"Subscription ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/subscriptions/get","api_endpoint":"https://api.polar.sh/v1/subscriptions/{subscription_id}"},"summary":"Get subscription","description":"Get a specific subscription by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Subscriptions"],"parameters":[{"name":"subscription_id","in":"path","description":"Subscription ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/subscriptions/update","api_endpoint":"https://api.polar.sh/v1/subscriptions/{subscription_id}"},"summary":"Update subscription","description":"Update a subscription","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"metadata":{"type":"object","description":"Additional metadata for the subscription","properties":{}}}},"example":{"metadata":{}}}}}}},"/subscriptions/{subscription_id}/cancel":{"post":{"tags":["Subscriptions"],"parameters":[{"name":"subscription_id","in":"path","description":"Subscription ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/subscriptions/cancel","api_endpoint":"https://api.polar.sh/v1/subscriptions/{subscription_id}/cancel"},"summary":"Cancel subscription","description":"Cancel a subscription","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/benefits":{"get":{"tags":["Benefits"],"parameters":[{"name":"limit","in":"query","description":"Number of items to return per page (window size), max 100","schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number, starting from 1","schema":{"type":"number","example":""}},{"name":"product_id","in":"query","description":"Filter benefits by product ID","schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/benefits/list","api_endpoint":"https://api.polar.sh/v1/benefits"},"summary":"List benefits","description":"List all benefits","security":[{"bearerAuth":[]}]},"post":{"tags":["Benefits"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/benefits/create","api_endpoint":"https://api.polar.sh/v1/benefits"},"summary":"Create benefit","description":"Create a new benefit","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"type":{"type":"string","description":"Benefit type","required":true},"description":{"type":"string","description":"Benefit description","required":true},"metadata":{"type":"object","description":"Additional metadata for the benefit","properties":{}},"product_id":{"type":"string","description":"Product ID","required":true},"properties":{"type":"object","description":"Benefit properties","properties":{}}}},"example":{"type":"","description":"","metadata":{},"product_id":"","properties":{}}}}}}},"/benefits/{benefit_id}":{"get":{"tags":["Benefits"],"parameters":[{"name":"benefit_id","in":"path","description":"Benefit ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/benefits/get","api_endpoint":"https://api.polar.sh/v1/benefits/{benefit_id}"},"summary":"Get benefit","description":"Get a specific benefit by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Benefits"],"parameters":[{"name":"benefit_id","in":"path","description":"Benefit ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/benefits/update","api_endpoint":"https://api.polar.sh/v1/benefits/{benefit_id}"},"summary":"Update benefit","description":"Update a benefit","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"description":{"type":"string","description":"Benefit description"},"metadata":{"type":"object","description":"Additional metadata for the benefit","properties":{}},"properties":{"type":"object","description":"Benefit properties","properties":{}}}},"example":{"description":"","metadata":{},"properties":{}}}}}},"delete":{"tags":["Benefits"],"parameters":[{"name":"benefit_id","in":"path","description":"Benefit ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/benefits/delete","api_endpoint":"https://api.polar.sh/v1/benefits/{benefit_id}"},"summary":"Delete benefit","description":"Delete a benefit","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/webhooks":{"get":{"tags":["Webhooks"],"parameters":[{"name":"limit","in":"query","description":"Number of items to return per page (window size), max 100","schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number, starting from 1","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/webhooks/list","api_endpoint":"https://api.polar.sh/v1/webhooks"},"summary":"List webhooks","description":"List all webhooks","security":[{"bearerAuth":[]}]},"post":{"tags":["Webhooks"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/webhooks/create","api_endpoint":"https://api.polar.sh/v1/webhooks"},"summary":"Create webhook","description":"Create a new webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"events":{"type":"array","description":"List of events to subscribe to","required":true,"items":{"type":"string"}},"metadata":{"type":"object","description":"Additional metadata for the webhook","properties":{}},"secret":{"type":"string","description":"Webhook secret for signature verification"},"url":{"type":"string","description":"Webhook URL","required":true}}},"example":{"events":[],"metadata":{},"secret":"","url":""}}}}}},"/webhooks/{webhook_id}":{"get":{"tags":["Webhooks"],"parameters":[{"name":"webhook_id","in":"path","description":"Webhook ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/webhooks/get","api_endpoint":"https://api.polar.sh/v1/webhooks/{webhook_id}"},"summary":"Get webhook","description":"Get a specific webhook by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Webhooks"],"parameters":[{"name":"webhook_id","in":"path","description":"Webhook ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/webhooks/update","api_endpoint":"https://api.polar.sh/v1/webhooks/{webhook_id}"},"summary":"Update webhook","description":"Update a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"events":{"type":"array","description":"List of events to subscribe to","items":{"type":"string"}},"metadata":{"type":"object","description":"Additional metadata for the webhook","properties":{}},"secret":{"type":"string","description":"Webhook secret for signature verification"},"url":{"type":"string","description":"Webhook URL"}}},"example":{"events":[],"metadata":{},"secret":"","url":""}}}}},"delete":{"tags":["Webhooks"],"parameters":[{"name":"webhook_id","in":"path","description":"Webhook ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/webhooks/delete","api_endpoint":"https://api.polar.sh/v1/webhooks/{webhook_id}"},"summary":"Delete webhook","description":"Delete a webhook","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/customers":{"get":{"tags":["Customers"],"parameters":[{"name":"email","in":"query","description":"Filter customers by email address","schema":{"type":"string","example":""}},{"name":"limit","in":"query","description":"Number of items to return per page (window size), max 100","schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number, starting from 1","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customers/list","api_endpoint":"https://api.polar.sh/v1/customers"},"summary":"List customers","description":"List all customers in your organization","security":[{"bearerAuth":[]}]},"post":{"tags":["Customers"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customers/create","api_endpoint":"https://api.polar.sh/v1/customers"},"summary":"Create customer","description":"Create a new customer","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"Customer email address","required":true},"metadata":{"type":"object","description":"Additional metadata for the customer","properties":{}},"name":{"type":"string","description":"Customer name"}}},"example":{"email":"","metadata":{},"name":""}}}}}},"/customers/{customer_id}":{"get":{"tags":["Customers"],"parameters":[{"name":"customer_id","in":"path","description":"Customer ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customers/get","api_endpoint":"https://api.polar.sh/v1/customers/{customer_id}"},"summary":"Get customer","description":"Get a specific customer by ID","security":[{"bearerAuth":[]}]},"patch":{"tags":["Customers"],"parameters":[{"name":"customer_id","in":"path","description":"Customer ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customers/update","api_endpoint":"https://api.polar.sh/v1/customers/{customer_id}"},"summary":"Update customer","description":"Update a customer","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"email":{"type":"string","description":"Customer email address"},"metadata":{"type":"object","description":"Additional metadata for the customer","properties":{}},"name":{"type":"string","description":"Customer name"}}},"example":{"email":"","metadata":{},"name":""}}}}},"delete":{"tags":["Customers"],"parameters":[{"name":"customer_id","in":"path","description":"Customer ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customers/delete","api_endpoint":"https://api.polar.sh/v1/customers/{customer_id}"},"summary":"Delete customer","description":"Delete a customer","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}},"/organizations":{"get":{"tags":["Organizations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/organizations/get","api_endpoint":"https://api.polar.sh/v1/organizations"},"summary":"Get organization","description":"Get the current organization details","security":[{"bearerAuth":[]}]},"patch":{"tags":["Organizations"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/organizations/update","api_endpoint":"https://api.polar.sh/v1/organizations"},"summary":"Update organization","description":"Update the current organization","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"metadata":{"type":"object","description":"Additional metadata for the organization","properties":{}},"name":{"type":"string","description":"Organization name"}}},"example":{"metadata":{},"name":""}}}}}},"/customer-sessions":{"post":{"tags":["Customer Sessions"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customer-portal/sessions/create","api_endpoint":"https://api.polar.sh/v1/customer-sessions"},"summary":"Create customer session","description":"Create a customer session and get a customer access token","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"customer_id":{"type":"string","description":"Customer ID","required":true},"expires_at":{"type":"string","description":"Session expiration timestamp (ISO 8601)"}}},"example":{"customer_id":"","expires_at":""}}}}}},"/customer-sessions/{session_id}":{"get":{"tags":["Customer Sessions"],"parameters":[{"name":"session_id","in":"path","description":"Session ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customer-portal/sessions/get","api_endpoint":"https://api.polar.sh/v1/customer-sessions/{session_id}"},"summary":"Get customer session","description":"Get a specific customer session by ID","security":[{"bearerAuth":[]}]}},"/customer-portal/orders":{"get":{"tags":["Customer Portal"],"parameters":[{"name":"limit","in":"query","description":"Number of items to return per page (window size), max 100","schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number, starting from 1","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customer-portal/orders/list","api_endpoint":"https://api.polar.sh/v1/customer-portal/orders"},"summary":"List customer orders","description":"List orders for the authenticated customer","security":[{"bearerAuth":[]}]}},"/customer-portal/orders/{order_id}":{"get":{"tags":["Customer Portal"],"parameters":[{"name":"order_id","in":"path","description":"Order ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customer-portal/orders/get","api_endpoint":"https://api.polar.sh/v1/customer-portal/orders/{order_id}"},"summary":"Get customer order","description":"Get a specific order for the authenticated customer","security":[{"bearerAuth":[]}]}},"/customer-portal/subscriptions":{"get":{"tags":["Customer Portal"],"parameters":[{"name":"limit","in":"query","description":"Number of items to return per page (window size), max 100","schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number, starting from 1","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customer-portal/subscriptions/list","api_endpoint":"https://api.polar.sh/v1/customer-portal/subscriptions"},"summary":"List customer subscriptions","description":"List subscriptions for the authenticated customer","security":[{"bearerAuth":[]}]}},"/customer-portal/subscriptions/{subscription_id}":{"get":{"tags":["Customer Portal"],"parameters":[{"name":"subscription_id","in":"path","description":"Subscription ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customer-portal/subscriptions/get","api_endpoint":"https://api.polar.sh/v1/customer-portal/subscriptions/{subscription_id}"},"summary":"Get customer subscription","description":"Get a specific subscription for the authenticated customer","security":[{"bearerAuth":[]}]}},"/customer-portal/benefits":{"get":{"tags":["Customer Portal"],"parameters":[{"name":"limit","in":"query","description":"Number of items to return per page (window size), max 100","schema":{"type":"number","example":""}},{"name":"page","in":"query","description":"Page number, starting from 1","schema":{"type":"number","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customer-portal/benefits/list","api_endpoint":"https://api.polar.sh/v1/customer-portal/benefits"},"summary":"List customer benefits","description":"List benefits for the authenticated customer","security":[{"bearerAuth":[]}]}},"/customer-portal/license-keys/validate":{"post":{"tags":["License Keys"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customer-portal/license-keys/validate","api_endpoint":"https://api.polar.sh/v1/customer-portal/license-keys/validate"},"summary":"Validate license key","description":"Validate a license key (unauthenticated)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"license_key":{"type":"string","description":"License key to validate","required":true}}},"example":{"license_key":""}}}}}},"/customer-portal/license-keys/activate":{"post":{"tags":["License Keys"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customer-portal/license-keys/activate","api_endpoint":"https://api.polar.sh/v1/customer-portal/license-keys/activate"},"summary":"Activate license key","description":"Activate a license key (unauthenticated)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"license_key":{"type":"string","description":"License key to activate","required":true},"machine_id":{"type":"string","description":"Machine identifier","required":true}}},"example":{"license_key":"","machine_id":""}}}}}},"/customer-portal/license-keys/deactivate":{"post":{"tags":["License Keys"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/customer-portal/license-keys/deactivate","api_endpoint":"https://api.polar.sh/v1/customer-portal/license-keys/deactivate"},"summary":"Deactivate license key","description":"Deactivate a license key (unauthenticated)","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"license_key":{"type":"string","description":"License key to deactivate","required":true},"machine_id":{"type":"string","description":"Machine identifier","required":true}}},"example":{"license_key":"","machine_id":""}}}}}},"/files":{"post":{"tags":["Files"],"parameters":[],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/files/upload","api_endpoint":"https://api.polar.sh/v1/files"},"summary":"Upload file","description":"Upload a file to the organization","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{"file":{"type":"string","format":"binary","description":"File to upload","required":true},"metadata":{"type":"object","description":"Additional metadata for the file","properties":{}},"purpose":{"type":"string","description":"Purpose of the file upload (e.g., product_image, logo)","required":true}}},"example":{"file":"(binary)","metadata":{},"purpose":""}}}}}},"/files/{file_id}":{"get":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"File ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/files/get","api_endpoint":"https://api.polar.sh/v1/files/{file_id}"},"summary":"Get file","description":"Get a specific file by ID","security":[{"bearerAuth":[]}]},"delete":{"tags":["Files"],"parameters":[{"name":"file_id","in":"path","description":"File ID","required":true,"schema":{"type":"string","example":""}}],"responses":{"401":{"description":"Bearer token required (Authorization header)","content":{"application/json":{}}}},"externalDocs":{"api_ref":"https://polar.sh/docs/api-reference/files/delete","api_endpoint":"https://api.polar.sh/v1/files/{file_id}"},"summary":"Delete file","description":"Delete a file","security":[{"bearerAuth":[]}],"requestBody":{"description":"","required":true,"content":{"application/json":{"schema":{"type":"object","required":[],"properties":{}},"example":{}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"security":[{"bearerAuth":[]}]}