Practices
List practices and turn a practice ID into the exact name required by several Tebra filters.
- Resource
client.practices- SOAP operation
GetPractices- Flat methods
get_practices,get_practice- Writes
- None
Methods
client.practices.list#
readasync list(*, practice_id=None, practice_name=None, active=None, npi=None, tax_id=None, from_created_date=None, to_created_date=None, from_last_modified_date=None, to_last_modified_date=None, fields=None, extra_filter=None) -> list[dict]List practices matching optional filters using GetPractices. Results also populate the in-memory practice ID → name cache used by other resources.
| Parameter | Type | Description |
|---|---|---|
practice_id | int | str | None | Filter by practice ID (sent as a string). |
practice_name | str | None | Filter by exact practice name. |
active | bool | str | None | Active flag. Booleans are sent as "True" / "False". |
npi | str | None | Filter by NPI. |
tax_id | str | None | Filter by Tax ID. |
from_created_date | str | date | datetime | None | Lower bound on creation date. |
to_created_date | str | date | datetime | None | Upper bound on creation date. |
from_last_modified_date | str | date | datetime | None | Lower bound on last-modified date. |
to_last_modified_date | str | date | datetime | None | Upper bound on last-modified date. |
fields | Iterable[str] | Mapping[str, bool] | None | Field selector. None sends Fields: {} to return all fields. |
extra_filter | Mapping[str, Any] | None | Additional raw Filter keys merged after None-stripping. |
list[dict[str, Any]] (empty list when nothing matches).practices = await client.practices.list(active=True)
for practice in practices:
print(practice["ID"], practice["PracticeName"])client.practices.get#
readasync get(practice_id=None, *, practice_name=None, fields=None) -> dict | NoneFetch a single practice by ID or name. With a name, an exact PracticeName filter is tried first, then a case-insensitive exact/substring scan over all practices. Returns None when nothing matches.
| Parameter | Type | Description |
|---|---|---|
practice_id | int | str | None | Practice ID. Required unless practice_name is given. |
practice_name | str | None | Practice name to match. |
fields | Iterable[str] | Mapping[str, bool] | None | Optional field selector. |
dict[str, Any] | NoneValueError when both practice_id and practice_name are omitted.client.practices.resolve#
readasync resolve(*, practice_id=None, practice_name=None) -> dictResolve a practice and return a normalized identifier block. Raises TebraNotFoundError when the practice cannot be found. Also refreshes the ID → name cache.
| Parameter | Type | Description |
|---|---|---|
practice_id | int | str | None | Practice ID to resolve. |
practice_name | str | None | Practice name to resolve. |
dict with PracticeID (int when numeric), PracticeName, NPI, and Active.info = await client.practices.resolve(practice_name="Becki Lentz Physical Therapy, Inc")
print(info["PracticeID"], info["PracticeName"])client.practices.resolve_name#
readasync resolve_name(*, practice_id=None, practice_name=None) -> str | NoneReturn practice_name directly when supplied, otherwise resolve practice_id into its exact PracticeName. Results are cached in memory for fast repeat calls. Returns None when no identifier is supplied.
str | Nonepractice_id work on GetAppointments, GetCharges, and GetTransactions, whose WSDL filters only accept a practice name.Example
# Direct filter
matches = await client.practices.list(practice_name="Becki Lentz Physical Therapy, Inc")
# Resolve an ID to a name (cached)
name = await client.practices.resolve_name(practice_id=7)
# Appointments accept practice_id because it is resolved for you
appointments = await client.get_appointments(
practice_id=7,
start_date="2026-04-01",
end_date="2026-04-16",
)