fulcrumpro 0.12.1

A lightweight Python SDK for the Fulcrum Pro API, built with `httpx2`.

FulcrumPro

A lightweight Python SDK for the Fulcrum Pro API, built on httpx.

Installation

pip install fulcrumpro

Or with uv:

uv add fulcrumpro

Requirements

• Python 3.14+

Quick Start

from fulcrumpro import FulcrumPro

client = FulcrumPro(api_token="your-api-token")

job = client.jobs.get("6a0e5cad7c2e97225f8def9c")
print(job["name"])

Use as a context manager to ensure the underlying HTTP connection is closed:

with FulcrumPro(api_token="your-api-token") as client:
    job = client.jobs.get("6a0e5cad7c2e97225f8def9c")

Authentication

All requests are authenticated with a Bearer token. Pass your API token when constructing the client:

client = FulcrumPro(api_token="your-api-token")

Resources

Jobs

# Get a job by ID
job = client.jobs.get("6a0e5cad7c2e97225f8def9c")

Error Handling

All non-2xx responses raise a FulcrumProError:

from fulcrumpro import FulcrumPro, FulcrumProError

client = FulcrumPro(api_token="your-api-token")

try:
    job = client.jobs.get("nonexistent-id")
except FulcrumProError as e:
    print(e.status_code)  # e.g. 404
    print(str(e))         # "FulcrumPro API error 404: not found"

Version History

See CHANGELOG.md.

Docs

Full API documentation can be found on GitHub Pages