Install and configure

reversecontact is the official Python client for the Reverse Contact API, distributed under the Apache-2.0 license. These pages describe the published 0.3.0 package.

Runtime requirements

The SDK needs Python 3.11 or later, with httpx>=0.27,<1 and pydantic>=2.7,<3. The package includes type hints for mypy and your editor.

• Package: reversecontact on PyPI
• Source code and issues: reversecontact-python on GitHub

Install

pip install reversecontact

uv add reversecontact

poetry add reversecontact

API key

Pass your API key to the client as api_key, or set the RC_API_KEY environment variable. When you omit api_key, the client reads RC_API_KEY.

The examples in these guides use the environment variable. You can use any server-side source, such as a secret manager. If you serve several workspaces, create one client per key. Keep the key on your server, out of your code and anything a browser loads. See Authentication to create a key.

export RC_API_KEY="your-api-key"

Create and close a client

Use a context manager to close the SDK's HTTP connection pool when your work ends. With RC_API_KEY set, create the client without passing a key:

from reversecontact import ReverseContact

with ReverseContact() as client:
    print(client.usage.retrieve().quotas)

You can also pass the key explicitly with ReverseContact(api_key=your_server_side_key), then call client.close() when finished. A missing or empty key raises ReverseContactError before the SDK sends an HTTP request. The SDK sends the key in an Authorization: Bearer header.

For asyncio applications, use async with AsyncReverseContact() or await client.close(). See the example in Async client.

Close any custom http_client yourself. Client options covers base URLs, connection pools, logging and per-client defaults. Once your client is configured, make your first call.

Return to the Python SDK overview.