client.py

# This file was auto-generated by Fern from our API Definition.

import typing

from ..core.client_wrapper import AsyncClientWrapper, SyncClientWrapper
from ..core.request_options import RequestOptions
from ..types.create_practice_response import CreatePracticeResponse
from ..types.get_practice_response import GetPracticeResponse
from ..types.list_practices_response import ListPracticesResponse
from ..types.update_practice_response import UpdatePracticeResponse
from .raw_client import AsyncRawPracticesClient, RawPracticesClient
from .types.create_practice_request_address import CreatePracticeRequestAddress
from .types.create_practice_request_attestations import CreatePracticeRequestAttestations
from .types.create_practice_request_compliance_contact import CreatePracticeRequestComplianceContact
from .types.create_practice_request_prescribers_item import CreatePracticeRequestPrescribersItem
from .types.create_practice_request_primary_contact import CreatePracticeRequestPrimaryContact
from .types.update_practice_request_address import UpdatePracticeRequestAddress
from .types.update_practice_request_attestations import UpdatePracticeRequestAttestations
from .types.update_practice_request_compliance_contact import UpdatePracticeRequestComplianceContact
from .types.update_practice_request_prescribers_item import UpdatePracticeRequestPrescribersItem
from .types.update_practice_request_primary_contact import UpdatePracticeRequestPrimaryContact

# this is used as the default value for optional parameters
OMIT = typing.cast(typing.Any, ...)


class PracticesClient:
    def __init__(self, *, client_wrapper: SyncClientWrapper):
        self._raw_client = RawPracticesClient(client_wrapper=client_wrapper)

    @property
    def with_raw_response(self) -> RawPracticesClient:
        """
        Retrieves a raw implementation of this client that returns raw responses.

        Returns
        -------
        RawPracticesClient
        """
        return self._raw_client

    def list(
        self,
        *,
        search: typing.Optional[str] = None,
        ending_before: typing.Optional[str] = None,
        limit: typing.Optional[int] = None,
        starting_after: typing.Optional[str] = None,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> ListPracticesResponse:
        """
        Returns the practices that belong to the platform. The default Affinity-Version is 2026-09-28.

        Parameters
        ----------
        search : typing.Optional[str]
            Case-insensitive search by practice name or external ID.

        ending_before : typing.Optional[str]

        limit : typing.Optional[int]

        starting_after : typing.Optional[str]

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        ListPracticesResponse
            HTTP 200

        Examples
        --------
        from affinity import Affinity

        client = Affinity(
            affinity_version="YOUR_AFFINITY_VERSION",
            api_key="YOUR_API_KEY",
        )
        client.practices.list(
            ending_before="prac_01j2y8m6jcc9tt24af5pw9x1bc",
            starting_after="prac_01j2y8m6jcc9tt24af5pw9x1bc",
        )
        """
        _response = self._raw_client.list(
            search=search,
            ending_before=ending_before,
            limit=limit,
            starting_after=starting_after,
            request_options=request_options,
        )
        return _response.data

    def create(
        self,
        *,
        address: CreatePracticeRequestAddress,
        attestations: CreatePracticeRequestAttestations,
        name: str,
        idempotency_key: typing.Optional[str] = None,
        live_enabled: typing.Optional[bool] = OMIT,
        compliance_contact: typing.Optional[CreatePracticeRequestComplianceContact] = OMIT,
        external_id: typing.Optional[str] = OMIT,
        legal_name: typing.Optional[str] = OMIT,
        metadata: typing.Optional[typing.Dict[str, typing.Any]] = OMIT,
        prescribers: typing.Optional[typing.Sequence[CreatePracticeRequestPrescribersItem]] = OMIT,
        primary_contact: typing.Optional[CreatePracticeRequestPrimaryContact] = OMIT,
        support_email: typing.Optional[str] = OMIT,
        support_phone: typing.Optional[str] = OMIT,
        timezone: typing.Optional[str] = OMIT,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> CreatePracticeResponse:
        """
        Creates a practice owned by the platform. Set liveEnabled to true to enable Live access at creation with an approved platform and a Live request. Defaults to false. Requires practices:write. Send Idempotency-Key when you retry the same request.

        Parameters
        ----------
        address : CreatePracticeRequestAddress

        attestations : CreatePracticeRequestAttestations

        name : str

        idempotency_key : typing.Optional[str]

        live_enabled : typing.Optional[bool]
            Enable Live access at creation. Requires an approved platform and a Live request. Defaults to false.

        compliance_contact : typing.Optional[CreatePracticeRequestComplianceContact]

        external_id : typing.Optional[str]

        legal_name : typing.Optional[str]

        metadata : typing.Optional[typing.Dict[str, typing.Any]]

        prescribers : typing.Optional[typing.Sequence[CreatePracticeRequestPrescribersItem]]

        primary_contact : typing.Optional[CreatePracticeRequestPrimaryContact]

        support_email : typing.Optional[str]

        support_phone : typing.Optional[str]

        timezone : typing.Optional[str]
            Optional IANA timezone override. Omit to leave unchanged; null clears it. No timezone is inferred when creating a record.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        CreatePracticeResponse
            HTTP 200

        Examples
        --------
        from affinity import Affinity
        from affinity.practices import (
            CreatePracticeRequestAddress,
            CreatePracticeRequestAttestations,
            CreatePracticeRequestPrescribersItem,
            CreatePracticeRequestPrimaryContact,
        )

        client = Affinity(
            affinity_version="YOUR_AFFINITY_VERSION",
            api_key="YOUR_API_KEY",
        )
        client.practices.create(
            address=CreatePracticeRequestAddress(
                city="Los Angeles",
                country="US",
                line1="100 Practice Way",
                postal_code="90001",
                state="CA",
            ),
            attestations=CreatePracticeRequestAttestations(
                authorized_practice_relationship=True,
                authorized_phi_transfer=True,
                minimum_necessary_phi=True,
                provider_data_accuracy=True,
            ),
            external_id="practice_123",
            legal_name="Example Medical Group PLLC",
            metadata={"key": "value"},
            name="Example Medical Group",
            prescribers=[
                CreatePracticeRequestPrescribersItem(
                    credentials="MD",
                    license_states=["CA"],
                    name="Alex Morgan",
                    npi="1234567893",
                )
            ],
            primary_contact=CreatePracticeRequestPrimaryContact(
                email="operations@example-practice.com",
                name="Jordan Lee",
            ),
            support_email="support@example-practice.com",
        )
        """
        _response = self._raw_client.create(
            address=address,
            attestations=attestations,
            name=name,
            idempotency_key=idempotency_key,
            live_enabled=live_enabled,
            compliance_contact=compliance_contact,
            external_id=external_id,
            legal_name=legal_name,
            metadata=metadata,
            prescribers=prescribers,
            primary_contact=primary_contact,
            support_email=support_email,
            support_phone=support_phone,
            timezone=timezone,
            request_options=request_options,
        )
        return _response.data

    def get(self, practice_id: str, *, request_options: typing.Optional[RequestOptions] = None) -> GetPracticeResponse:
        """
        Returns one practice that belongs to the platform.

        Parameters
        ----------
        practice_id : str

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        GetPracticeResponse
            HTTP 200

        Examples
        --------
        from affinity import Affinity

        client = Affinity(
            affinity_version="YOUR_AFFINITY_VERSION",
            api_key="YOUR_API_KEY",
        )
        client.practices.get(
            practice_id="prac_01j2y8m6jcc9tt24af5pw9x1bc",
        )
        """
        _response = self._raw_client.get(practice_id, request_options=request_options)
        return _response.data

    def update(
        self,
        practice_id: str,
        *,
        idempotency_key: typing.Optional[str] = None,
        live_enabled: typing.Optional[bool] = OMIT,
        address: typing.Optional[UpdatePracticeRequestAddress] = OMIT,
        attestations: typing.Optional[UpdatePracticeRequestAttestations] = OMIT,
        compliance_contact: typing.Optional[UpdatePracticeRequestComplianceContact] = OMIT,
        external_id: typing.Optional[str] = OMIT,
        legal_name: typing.Optional[str] = OMIT,
        metadata: typing.Optional[typing.Dict[str, typing.Any]] = OMIT,
        name: typing.Optional[str] = OMIT,
        prescribers: typing.Optional[typing.Sequence[UpdatePracticeRequestPrescribersItem]] = OMIT,
        primary_contact: typing.Optional[UpdatePracticeRequestPrimaryContact] = OMIT,
        support_email: typing.Optional[str] = OMIT,
        support_phone: typing.Optional[str] = OMIT,
        timezone: typing.Optional[str] = OMIT,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> UpdatePracticeResponse:
        """
        Updates one practice owned by the platform. Set liveEnabled to true or false to control Live access with an approved platform and a Live request. Affinity Admin decisions take precedence. Requires practices:write. Send Idempotency-Key when you retry the same request.

        Parameters
        ----------
        practice_id : str

        idempotency_key : typing.Optional[str]
            Optional in the SDK. A fresh key is generated once per call when omitted. Supply a stable key to retry across calls.

        live_enabled : typing.Optional[bool]
            Enable or disable Live access for an owned practice. Requires an approved platform and a Live request. Affinity Admin decisions take precedence.

        address : typing.Optional[UpdatePracticeRequestAddress]

        attestations : typing.Optional[UpdatePracticeRequestAttestations]

        compliance_contact : typing.Optional[UpdatePracticeRequestComplianceContact]

        external_id : typing.Optional[str]

        legal_name : typing.Optional[str]

        metadata : typing.Optional[typing.Dict[str, typing.Any]]

        name : typing.Optional[str]

        prescribers : typing.Optional[typing.Sequence[UpdatePracticeRequestPrescribersItem]]

        primary_contact : typing.Optional[UpdatePracticeRequestPrimaryContact]

        support_email : typing.Optional[str]

        support_phone : typing.Optional[str]

        timezone : typing.Optional[str]
            Optional IANA timezone override. Omit to leave unchanged; null clears it. No timezone is inferred when creating a record.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        UpdatePracticeResponse
            HTTP 200

        Examples
        --------
        from affinity import Affinity

        client = Affinity(
            affinity_version="YOUR_AFFINITY_VERSION",
            api_key="YOUR_API_KEY",
        )
        client.practices.update(
            practice_id="prac_01j2y8m6jcc9tt24af5pw9x1bc",
        )
        """
        _response = self._raw_client.update(
            practice_id,
            idempotency_key=idempotency_key,
            live_enabled=live_enabled,
            address=address,
            attestations=attestations,
            compliance_contact=compliance_contact,
            external_id=external_id,
            legal_name=legal_name,
            metadata=metadata,
            name=name,
            prescribers=prescribers,
            primary_contact=primary_contact,
            support_email=support_email,
            support_phone=support_phone,
            timezone=timezone,
            request_options=request_options,
        )
        return _response.data


class AsyncPracticesClient:
    def __init__(self, *, client_wrapper: AsyncClientWrapper):
        self._raw_client = AsyncRawPracticesClient(client_wrapper=client_wrapper)

    @property
    def with_raw_response(self) -> AsyncRawPracticesClient:
        """
        Retrieves a raw implementation of this client that returns raw responses.

        Returns
        -------
        AsyncRawPracticesClient
        """
        return self._raw_client

    async def list(
        self,
        *,
        search: typing.Optional[str] = None,
        ending_before: typing.Optional[str] = None,
        limit: typing.Optional[int] = None,
        starting_after: typing.Optional[str] = None,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> ListPracticesResponse:
        """
        Returns the practices that belong to the platform. The default Affinity-Version is 2026-09-28.

        Parameters
        ----------
        search : typing.Optional[str]
            Case-insensitive search by practice name or external ID.

        ending_before : typing.Optional[str]

        limit : typing.Optional[int]

        starting_after : typing.Optional[str]

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        ListPracticesResponse
            HTTP 200

        Examples
        --------
        import asyncio

        from affinity import AsyncAffinity

        client = AsyncAffinity(
            affinity_version="YOUR_AFFINITY_VERSION",
            api_key="YOUR_API_KEY",
        )


        async def main() -> None:
            await client.practices.list(
                ending_before="prac_01j2y8m6jcc9tt24af5pw9x1bc",
                starting_after="prac_01j2y8m6jcc9tt24af5pw9x1bc",
            )


        asyncio.run(main())
        """
        _response = await self._raw_client.list(
            search=search,
            ending_before=ending_before,
            limit=limit,
            starting_after=starting_after,
            request_options=request_options,
        )
        return _response.data

    async def create(
        self,
        *,
        address: CreatePracticeRequestAddress,
        attestations: CreatePracticeRequestAttestations,
        name: str,
        idempotency_key: typing.Optional[str] = None,
        live_enabled: typing.Optional[bool] = OMIT,
        compliance_contact: typing.Optional[CreatePracticeRequestComplianceContact] = OMIT,
        external_id: typing.Optional[str] = OMIT,
        legal_name: typing.Optional[str] = OMIT,
        metadata: typing.Optional[typing.Dict[str, typing.Any]] = OMIT,
        prescribers: typing.Optional[typing.Sequence[CreatePracticeRequestPrescribersItem]] = OMIT,
        primary_contact: typing.Optional[CreatePracticeRequestPrimaryContact] = OMIT,
        support_email: typing.Optional[str] = OMIT,
        support_phone: typing.Optional[str] = OMIT,
        timezone: typing.Optional[str] = OMIT,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> CreatePracticeResponse:
        """
        Creates a practice owned by the platform. Set liveEnabled to true to enable Live access at creation with an approved platform and a Live request. Defaults to false. Requires practices:write. Send Idempotency-Key when you retry the same request.

        Parameters
        ----------
        address : CreatePracticeRequestAddress

        attestations : CreatePracticeRequestAttestations

        name : str

        idempotency_key : typing.Optional[str]

        live_enabled : typing.Optional[bool]
            Enable Live access at creation. Requires an approved platform and a Live request. Defaults to false.

        compliance_contact : typing.Optional[CreatePracticeRequestComplianceContact]

        external_id : typing.Optional[str]

        legal_name : typing.Optional[str]

        metadata : typing.Optional[typing.Dict[str, typing.Any]]

        prescribers : typing.Optional[typing.Sequence[CreatePracticeRequestPrescribersItem]]

        primary_contact : typing.Optional[CreatePracticeRequestPrimaryContact]

        support_email : typing.Optional[str]

        support_phone : typing.Optional[str]

        timezone : typing.Optional[str]
            Optional IANA timezone override. Omit to leave unchanged; null clears it. No timezone is inferred when creating a record.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        CreatePracticeResponse
            HTTP 200

        Examples
        --------
        import asyncio

        from affinity import AsyncAffinity
        from affinity.practices import (
            CreatePracticeRequestAddress,
            CreatePracticeRequestAttestations,
            CreatePracticeRequestPrescribersItem,
            CreatePracticeRequestPrimaryContact,
        )

        client = AsyncAffinity(
            affinity_version="YOUR_AFFINITY_VERSION",
            api_key="YOUR_API_KEY",
        )


        async def main() -> None:
            await client.practices.create(
                address=CreatePracticeRequestAddress(
                    city="Los Angeles",
                    country="US",
                    line1="100 Practice Way",
                    postal_code="90001",
                    state="CA",
                ),
                attestations=CreatePracticeRequestAttestations(
                    authorized_practice_relationship=True,
                    authorized_phi_transfer=True,
                    minimum_necessary_phi=True,
                    provider_data_accuracy=True,
                ),
                external_id="practice_123",
                legal_name="Example Medical Group PLLC",
                metadata={"key": "value"},
                name="Example Medical Group",
                prescribers=[
                    CreatePracticeRequestPrescribersItem(
                        credentials="MD",
                        license_states=["CA"],
                        name="Alex Morgan",
                        npi="1234567893",
                    )
                ],
                primary_contact=CreatePracticeRequestPrimaryContact(
                    email="operations@example-practice.com",
                    name="Jordan Lee",
                ),
                support_email="support@example-practice.com",
            )


        asyncio.run(main())
        """
        _response = await self._raw_client.create(
            address=address,
            attestations=attestations,
            name=name,
            idempotency_key=idempotency_key,
            live_enabled=live_enabled,
            compliance_contact=compliance_contact,
            external_id=external_id,
            legal_name=legal_name,
            metadata=metadata,
            prescribers=prescribers,
            primary_contact=primary_contact,
            support_email=support_email,
            support_phone=support_phone,
            timezone=timezone,
            request_options=request_options,
        )
        return _response.data

    async def get(
        self, practice_id: str, *, request_options: typing.Optional[RequestOptions] = None
    ) -> GetPracticeResponse:
        """
        Returns one practice that belongs to the platform.

        Parameters
        ----------
        practice_id : str

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        GetPracticeResponse
            HTTP 200

        Examples
        --------
        import asyncio

        from affinity import AsyncAffinity

        client = AsyncAffinity(
            affinity_version="YOUR_AFFINITY_VERSION",
            api_key="YOUR_API_KEY",
        )


        async def main() -> None:
            await client.practices.get(
                practice_id="prac_01j2y8m6jcc9tt24af5pw9x1bc",
            )


        asyncio.run(main())
        """
        _response = await self._raw_client.get(practice_id, request_options=request_options)
        return _response.data

    async def update(
        self,
        practice_id: str,
        *,
        idempotency_key: typing.Optional[str] = None,
        live_enabled: typing.Optional[bool] = OMIT,
        address: typing.Optional[UpdatePracticeRequestAddress] = OMIT,
        attestations: typing.Optional[UpdatePracticeRequestAttestations] = OMIT,
        compliance_contact: typing.Optional[UpdatePracticeRequestComplianceContact] = OMIT,
        external_id: typing.Optional[str] = OMIT,
        legal_name: typing.Optional[str] = OMIT,
        metadata: typing.Optional[typing.Dict[str, typing.Any]] = OMIT,
        name: typing.Optional[str] = OMIT,
        prescribers: typing.Optional[typing.Sequence[UpdatePracticeRequestPrescribersItem]] = OMIT,
        primary_contact: typing.Optional[UpdatePracticeRequestPrimaryContact] = OMIT,
        support_email: typing.Optional[str] = OMIT,
        support_phone: typing.Optional[str] = OMIT,
        timezone: typing.Optional[str] = OMIT,
        request_options: typing.Optional[RequestOptions] = None,
    ) -> UpdatePracticeResponse:
        """
        Updates one practice owned by the platform. Set liveEnabled to true or false to control Live access with an approved platform and a Live request. Affinity Admin decisions take precedence. Requires practices:write. Send Idempotency-Key when you retry the same request.

        Parameters
        ----------
        practice_id : str

        idempotency_key : typing.Optional[str]
            Optional in the SDK. A fresh key is generated once per call when omitted. Supply a stable key to retry across calls.

        live_enabled : typing.Optional[bool]
            Enable or disable Live access for an owned practice. Requires an approved platform and a Live request. Affinity Admin decisions take precedence.

        address : typing.Optional[UpdatePracticeRequestAddress]

        attestations : typing.Optional[UpdatePracticeRequestAttestations]

        compliance_contact : typing.Optional[UpdatePracticeRequestComplianceContact]

        external_id : typing.Optional[str]

        legal_name : typing.Optional[str]

        metadata : typing.Optional[typing.Dict[str, typing.Any]]

        name : typing.Optional[str]

        prescribers : typing.Optional[typing.Sequence[UpdatePracticeRequestPrescribersItem]]

        primary_contact : typing.Optional[UpdatePracticeRequestPrimaryContact]

        support_email : typing.Optional[str]

        support_phone : typing.Optional[str]

        timezone : typing.Optional[str]
            Optional IANA timezone override. Omit to leave unchanged; null clears it. No timezone is inferred when creating a record.

        request_options : typing.Optional[RequestOptions]
            Request-specific configuration.

        Returns
        -------
        UpdatePracticeResponse
            HTTP 200

        Examples
        --------
        import asyncio

        from affinity import AsyncAffinity

        client = AsyncAffinity(
            affinity_version="YOUR_AFFINITY_VERSION",
            api_key="YOUR_API_KEY",
        )


        async def main() -> None:
            await client.practices.update(
                practice_id="prac_01j2y8m6jcc9tt24af5pw9x1bc",
            )


        asyncio.run(main())
        """
        _response = await self._raw_client.update(
            practice_id,
            idempotency_key=idempotency_key,
            live_enabled=live_enabled,
            address=address,
            attestations=attestations,
            compliance_contact=compliance_contact,
            external_id=external_id,
            legal_name=legal_name,
            metadata=metadata,
            name=name,
            prescribers=prescribers,
            primary_contact=primary_contact,
            support_email=support_email,
            support_phone=support_phone,
            timezone=timezone,
            request_options=request_options,
        )
        return _response.data