Without the SDK

The API uses JSON over HTTPS and works with any HTTP client. Send your key in an Authorization: Bearer header, as shown in the cURL examples on each endpoint page. To generate your own typed models, use the OpenAPI spec at https://docs.reversecontact.com/openapi.json.

Follow the rules in Error handling & retries and Polling. The SDK handles these for you.

Send a request with httpx

The free Usage endpoint returns workspace credit information in quotas.

import os

import httpx

with httpx.Client(timeout=90.0) as client:
    response = client.get(
        "https://api.reversecontact.com/v2/usage",
        headers={"Authorization": f"Bearer {os.environ['RC_API_KEY']}"},
    )
    response.raise_for_status()
    print(response.json().get("quotas"))

Install httpx in your application before running this example. Raw HTTP responses use the API's camelCase fields. The SDK converts known fields to Python model attributes for you.

Choose what your integration handles

With a raw HTTP client, implement the API's retry and polling rules in your own code. The Python SDK error guide and Async jobs explain how reversecontact handles retries and jobs. For JavaScript or TypeScript applications, see the TypeScript SDK overview.

Return to the Python SDK overview.