Python SDK (Beta)

1
import os
2
3
from collate import Collate
4
5
collate = Collate(
6
    api_key=os.environ["COLLATE_API_KEY"],
7
    environment=os.environ.get("COLLATE_BASE_URL", "https://api.sandbox.trycollate.ai"),
8
)

1
collate = Collate(
2
    api_key="your-sandbox-api-key",
3
    environment="https://api.sandbox.trycollate.ai",
4
)

1
import uuid
2
3
authorization = collate.authorizations.create(
4
    provider_npi="1234567893",
5
    request={
6
        "payer_id": "payer_aetna",
7
        "coverage_state": "CA",
8
        "request_type": "drug",
9
        "service_code": {"system": "hcpcs", "code": "J0791"},
10
    },
11
    policy={"final_submission": "requires_approval"},
12
    metadata={"external_case_id": "case_789"},
13
    idempotency_key=str(uuid.uuid4()),
14
)
15
16
print(authorization.id)
17
print(authorization.status)
18
print(authorization.next_action.type if authorization.next_action else None)

1
authorization = collate.authorizations.answers.patch(
2
    authorization_id=authorization.id,
3
    if_match=f'"{authorization.version}"',
4
    answers={
5
        "item": [
6
            {
7
                "link_id": "coverage.member_id",
8
                "answer": [{"value_string": "W123456789"}],
9
            },
10
            {
11
                "link_id": "request.diagnosis_code",
12
                "answer": [{"value_string": "D57.1"}],
13
            },
14
        ]
15
    },
16
)

1
import requests
2
3
created = collate.files.create(
4
    file_name="clinical-note.pdf",
5
    content_type="application/pdf",
6
    purpose="authorization_attachment",
7
)
8
9
with open("clinical-note.pdf", "rb") as file:
10
    upload = requests.put(
11
        created.upload.url,
12
        data=file,
13
        headers=created.upload.headers or {},
14
        timeout=60,
15
    )
16
upload.raise_for_status()
17
18
file_record = collate.files.complete(file_id=created.file.id)
19
20
authorization = collate.authorizations.attachments.create(
21
    authorization_id=authorization.id,
22
    if_match=f'"{authorization.version}"',
23
    file_id=file_record.id,
24
    document_types=["clinical_notes"],
25
)

1
from collate import ConfirmAuthorizationBody
2
3
request = None
4
5
if authorization.next_action and authorization.next_action.type == "approve_submission":
6
    request = ConfirmAuthorizationBody(
7
        accepted_review_snapshot_id=authorization.submission.review_snapshot.id,
8
    )
9
10
authorization = collate.authorizations.confirm(
11
    authorization_id=authorization.id,
12
    if_match=f'"{authorization.version}"',
13
    request=request,
14
)

1
import time
2
3
while authorization.status in {"processing", "waiting_on_payer"}:
4
    time.sleep(5 if authorization.status == "processing" else 30)
5
    authorization = collate.authorizations.retrieve(
6
        authorization_id=authorization.id,
7
    )
8
9
if authorization.status == "requires_action":
10
    print("Next action:", authorization.next_action.type)
11
elif authorization.status == "completed":
12
    print("Outcome:", authorization.outcome)

1
import asyncio
2
import os
3
4
from collate import AsyncCollate
5
6
7
async def main() -> None:
8
    collate = AsyncCollate(
9
        api_key=os.environ["COLLATE_API_KEY"],
10
        environment="https://api.sandbox.trycollate.ai",
11
    )
12
    authorization = await collate.authorizations.retrieve(
13
        authorization_id="auth_123",
14
    )
15
    print(authorization.status)
16
17
18
asyncio.run(main())

1
from collate.core.api_error import ApiError
2
3
try:
4
    authorization = collate.authorizations.retrieve(authorization_id="auth_123")
5
except ApiError as error:
6
    print(error.status_code)
7
    print(error.body)