pypresscart

An unofficial, typed Python client library for the Presscart API.

Warning

This project is not affiliated with, endorsed by, or supported by Presscart. It’s a community-maintained Python client.

What you get

  • Typed resource methods: client.outlets.list(...), client.orders.create_checkout(...), and 40+ more.

  • Dual-mode I/O: pass Pydantic models or plain dicts; get Pydantic models or plain dicts back.

  • Minimal deps: only requests and pydantic at runtime.

  • Built-in retries: exponential backoff with jitter on 429 / 5xx, honoring Retry-After.

  • Typed exceptions: BadRequestError, AuthenticationError, RateLimitError, and more.

60-second tour

from pypresscart import PresscartClient

with PresscartClient(api_token="pc_...") as client:
    me = client.auth.whoami()
    print(me.team_id, me.scopes)

    for outlet in client.outlets.list(limit=5).records:
        print(outlet.outlet_name, outlet.website_url)

Next steps

🚀 Get started

Install, authenticate, and make your first API call.

Getting Started
🔧 Configure the client

Timeouts, retries, JSON mode, custom sessions.

Client Configuration
📚 Browse resources

Reference docs for every resource service.

Outlets
🧪 Recipes

End-to-end workflows: campaign setup, pagination, FastAPI wiring, more.

Recipes