---
id: prelude-python-sdk
version: "0.13.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# prelude-python-sdk — The official Python library for the Prelude API

License: permissive · Maintenance: active · Downloads: 1.0M/mo

## What it is and what it does

This is the official Python client library for the Prelude REST API, generated using Stainless. It wraps the Prelude service's endpoints in a typed, object-oriented interface that works with modern Python versions. The library provides both synchronous (Prelude) and asynchronous (AsyncPrelude) clients, both powered by httpx under the hood, with full type hints for request parameters and response objects via Pydantic models and TypedDicts.

Typical usage involves instantiating a client with your API token, then calling methods like verification.create() to interact with the Prelude service. The library handles connection errors, rate limiting, timeouts, and retries automatically. It supports optional aiohttp as an HTTP backend for improved async concurrency. All responses are Pydantic models with helper methods for JSON serialization and dictionary conversion, and the library includes detailed error types for different HTTP status codes.

Use it for:

- Integrate phone number or email verification into a Python application using Prelude's verification API.
- Build async-first services that call Prelude endpoints concurrently without blocking.
- Develop type-safe API integrations with IDE autocomplete and static type checking for Prelude requests and responses.
- Handle API errors gracefully by catching specific exception types (RateLimitError, AuthenticationError, etc.) and implementing retry logic.
- Configure per-request timeouts and retry policies for different verification workflows.

## Worth the install?

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

Provides a typed Python client for the Prelude REST API with both synchronous and asynchronous interfaces, generated with Stainless.

Yes. This is a well-maintained, actively developed official SDK with no known vulnerabilities, low install friction, and permissive licensing. It supports current Python versions and provides both sync and async interfaces with full type safety. Install it if you need to integrate Prelude's verification service into a Python application.

## Install

pip install prelude-python-sdk
uv add prelude-python-sdk
poetry add prelude-python-sdk

## Installing prelude-python-sdk

Before you install: Low friction install with a pure Python wheel. Actively maintained as of 2 days ago with recent commits. Supports current Python versions (3.9 through 3.14) and carries no known vulnerabilities.

License in practice: Apache-2.0 is a permissive license; you can use this library in commercial and proprietary projects with minimal restrictions, provided you include a copy of the license and note any modifications.

Quickstart:

pip install prelude-python-sdk

import os
from prelude_python_sdk import Prelude

client = Prelude(api_token=os.environ.get("API_TOKEN"))
verification = client.verification.create(
    target={"type": "phone_number", "value": "+30123456789"}
)
print(verification.id)

Requires Python 3.9 or later and a valid Prelude API token (typically set via environment variable).

Verify before relying:

- Whether the Prelude service itself has SLAs or uptime guarantees relevant to production use.
- Performance characteristics and rate limits of the underlying Prelude API.
- Whether aiohttp backend provides measurable concurrency improvements for typical workloads.

## Package facts

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

## Tags

prelude api client python, rest api client library, async http client sdk, typed api wrapper, prelude verification api, python sdk generator, httpx-based api client, api-client, async-support, type-safe

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