Skip to content

assured-py

Unofficial Python SDK for the Assured Platform API

CI CodeQL PyPI License

A modern, async-first Python SDK wrapping the Assured Platform API. Built with fully typed Pydantic v2 models, automatic semantic pagination, and robust file handling designed to streamline interactions with Assured's complex backend.

Why assured-py?

The Assured Platform API has extensive undocumented behaviors, silent endpoint migrations, and multi-stage workflows that aren't obvious from the OpenAPI spec alone. This SDK was built to bridge those gaps — handling encrypted SSNs, JWT session management, S3 file orchestration, and more, so you don't have to.

Key Features

  • ⚡ Async First — Built on httpx for highly concurrent workflows
  • 🛡 Type Safety — Pydantic v2 models for every request and response
  • 📄 Auto-Pagination — Pull all records or export directly to pandas.DataFrame
  • 🔑 Session Bridge — Transparent JWT caching for undocumented endpoints
  • 📁 File Orchestration — Single-call upload + associate for provider documents
  • 🔒 SSN Encryption — AES-256-CTR encryption matching the platform's frontend scheme

Quick Example

import asyncio
from assured import AssuredClient

async def main():
    async with AssuredClient() as client:
        # List all providers as a DataFrame
        df = await client.providers.list_df()
        print(df[["full_name", "npi", "email"]])

        # Upload and associate a document in one call
        with open("contract.pdf", "rb") as f:
            doc = await client.provider_profile.upload_and_associate_document(
                provider_id="...",
                file_content=f.read(),
                filename="contract.pdf",
                document_name="Provider Agreement",
                document_type="Individual Provider Agreement",
            )

asyncio.run(main())

Resources at a Glance

Resource Access Description
Users client.users User management, login, password resets
Providers client.providers List, search, invite, NPI lookup
Provider Profile client.provider_profile Demographics, licenses, DEA, certifications, documents
Credentialing client.credentialing Verification requests and tasks
Payer Enrollment client.payer_enrollment Health plans, enrollment requests, active enrollments
Files client.files S3 uploads and presigned URL generation

Get started with the installation guide, or dive into the API reference.