---
id: orb-billing
version: "4.68.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# orb-billing — The official Python library for the orb API

License: permissive · Maintenance: active · Downloads: 874.4K/mo

## What it is and what it does

orb-billing is the official Python client for the Orb billing platform API. It wraps Orb's REST endpoints with type-safe request and response objects, offering both synchronous and asynchronous clients powered by httpx. The library includes full type hints for IDE autocomplete, Pydantic models for responses with serialization helpers, and built-in pagination support for list operations.

Developers use it to integrate Orb's subscription billing, metering, and invoicing into Python applications. The library handles authentication via API keys, automatic retries on transient failures, webhook signature verification, and detailed error types for different HTTP status codes. It supports modern Python versions (3.9 through 3.14) and runs on all major operating systems.

Use it for:

- Create and manage customer accounts and billing addresses in Orb from a Python backend.
- Fetch paginated lists of coupons, subscriptions, or invoices with automatic page handling.
- Handle incoming Orb webhooks with built-in signature verification to ensure authenticity.
- Build async billing workflows using the AsyncOrb client with optional aiohttp backend for concurrency.
- Catch and handle specific API errors (rate limits, auth failures, validation errors) with typed exception classes.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A Python client library for the Orb billing REST API, providing typed request and response objects with both synchronous and asynchronous interfaces.

Yes. The library is actively maintained, has no known vulnerabilities, low install friction, and permissive licensing. Install it if you are building a Python application that integrates with Orb's billing platform and want type-safe, well-documented API access.

## Install

pip install orb-billing
uv add orb-billing
poetry add orb-billing

## Installing orb-billing

Before you install: Low install friction with a pure-Python wheel and six common runtime dependencies. Actively maintained with a release within the past week and recent commits.

License in practice: Apache-2.0 permissive license allows commercial and private use with minimal restrictions; suitable for most projects.

Quickstart:

pip install orb-billing

import os
from orb import Orb

client = Orb(api_key=os.environ.get("ORB_API_KEY"))
customer = client.customers.create(
    email="example@withorb.com",
    name="My Customer"
)
print(customer.id)

Requires Python 3.9 or later; API key must be provided via environment variable or constructor argument.

Verify before relying:

- Whether the library's auto-retry behavior (2 times by default) is configurable for production use cases.
- Performance characteristics and latency overhead of the typed Pydantic response layer under high throughput.
- Whether webhook verification helpers work with all common Python web frameworks beyond FastAPI.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 874.4K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

orb billing api client, python billing platform sdk, async rest api client, typed api wrapper, subscription billing api, orb python library, http api client generator, billing-platform, async-first, type-safe

[View on SkillFed](https://skillfed.io/packages/orb-billing) · [View on PyPI](https://pypi.org/project/orb-billing/)