Python SDK

The official Python SDK provides fully typed synchronous and asynchronous clients for the Polar API.

The new SDK is currently in public preview. Install the pre-release explicitly to try it before the stable release.

Installation

The SDK requires Python 3.11 or later.

Terminal

uv add polar-sdk --prerelease allow

Terminal

pip install --pre polar-sdk

Quickstart

Create an organization access token, store it in POLAR_ACCESS_TOKEN, and make your first request:

main.py

import os

from polar.v2026_04 import Polar

polar = Polar(os.environ["POLAR_ACCESS_TOKEN"])

customer_state = polar.customers.get_state_external("customer_external_id")
print(customer_state)

Async client

Use PolarAsync in asynchronous applications:

async_main.py

import asyncio
import os

from polar.v2026_04 import PolarAsync


async def main() -> None:
    polar = PolarAsync(os.environ["POLAR_ACCESS_TOKEN"])
    customer_state = await polar.customers.get_state_external(
        "customer_external_id"
    )
    print(customer_state)


asyncio.run(main())

The import path pins your client to the 2026-04 API version.

Context managers

Both clients support context managers to close their HTTP connections automatically when the block exits. For synchronous applications, use Polar with with:

import os

from polar.v2026_04 import Polar

with Polar(os.environ["POLAR_ACCESS_TOKEN"]) as polar:
    customer_state = polar.customers.get_state_external("customer_external_id")
    print(customer_state)

For asynchronous applications, use PolarAsync with async with:

import asyncio
import os

from polar.v2026_04 import PolarAsync


async def main() -> None:
    async with PolarAsync(os.environ["POLAR_ACCESS_TOKEN"]) as polar:
        customer_state = await polar.customers.get_state_external(
            "customer_external_id"
        )
        print(customer_state)


asyncio.run(main())

Sandbox environment

The client uses production by default. Pass environment="sandbox" to use the isolated sandbox environment:

polar = Polar(
    os.environ["POLAR_ACCESS_TOKEN"],
    environment="sandbox",
)

View the source code on GitHub.

Bootup

Features

Integrate

Merchant of Record (MoR)

Installation

Quickstart

Async client

Context managers

Sandbox environment

​Installation

​Quickstart

​Async client

​Context managers

​Sandbox environment

Installation

Quickstart

Async client

Context managers

Sandbox environment