---
id: lithic
version: "0.125.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# lithic — The official Python library for the lithic API

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

## What it is and what it does

Lithic is the official Python SDK for the Lithic card issuance and payment API. It wraps the REST API with full type annotations, offering both synchronous and asynchronous clients powered by httpx. The library handles authentication via environment variables, provides auto-paginating iterators for list operations, and includes webhook parsing and signature verification.

The package is designed for developers building payment and card management features. It includes typed request parameters and Pydantic response models, supports nested parameters as TypedDicts, and offers helper methods for serialization. An optional aiohttp backend is available for improved async concurrency, and webhook verification requires the optional standardwebhooks package.

Use it for:

- Create and manage single-use or physical payment cards programmatically in a sandbox or production environment.
- Iterate through paginated card lists automatically without manually handling page cursors or successive requests.
- Parse and verify incoming webhook events from Lithic with signature validation for event-driven workflows.
- Build async-first payment applications using AsyncLithic with optional aiohttp for high-concurrency scenarios.
- Integrate card issuance into web frameworks with full type hints for IDE autocomplete and type checking.

## Worth the install?

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

Provides a typed Python client for the Lithic REST API, supporting both synchronous and asynchronous card management and payment operations with automatic pagination and webhook handling.

Yes. This is the official Lithic SDK with active maintenance, low install friction, permissive licensing, no known vulnerabilities, and solid popularity. Install it if you need to integrate Lithic's card issuance or payment API into a Python application.

## Install

pip install lithic
uv add lithic
poetry add lithic

## Installing lithic

Before you install: Low friction installation with standard dependencies. Actively maintained with recent releases; repository shows consistent activity and no archived status.

License in practice: Apache-2.0 permissive license allows commercial use, modification, and distribution with minimal restrictions—suitable for most projects.

Quickstart:

pip install lithic

import os
from lithic import Lithic

client = Lithic(api_key=os.environ.get("LITHIC_API_KEY"), environment="sandbox")
card = client.cards.create(type="SINGLE_USE")
print(card.token)

Requires Python 3.9 or later and a valid Lithic API key set via LITHIC_API_KEY environment variable.

Verify before relying:

- Whether the MCP Server integration is production-ready or still experimental.
- Performance characteristics when handling high-volume pagination across large result sets.
- Whether aiohttp backend provides measurable concurrency improvement for typical workloads.

## Package facts

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

## Tags

lithic api client python, payment card management sdk, async http client wrapper, rest api python library, typed api client, card issuance sdk, webhook signature verification, payment-api, async-support, type-hints

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