Ttebra_soap_apiAsync Tebra SOAP 2.1
SOAP 2.1
Resources

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#

read
async 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.

Parameters
ParameterTypeDescription
practice_idint | str | NoneFilter by practice ID (sent as a string).
practice_namestr | NoneFilter by exact practice name.
activebool | str | NoneActive flag. Booleans are sent as "True" / "False".
npistr | NoneFilter by NPI.
tax_idstr | NoneFilter by Tax ID.
from_created_datestr | date | datetime | NoneLower bound on creation date.
to_created_datestr | date | datetime | NoneUpper bound on creation date.
from_last_modified_datestr | date | datetime | NoneLower bound on last-modified date.
to_last_modified_datestr | date | datetime | NoneUpper bound on last-modified date.
fieldsIterable[str] | Mapping[str, bool] | NoneField selector. None sends Fields: {} to return all fields.
extra_filterMapping[str, Any] | NoneAdditional raw Filter keys merged after None-stripping.
Returnslist[dict[str, Any]] (empty list when nothing matches).
Example
practices = await client.practices.list(active=True)
for practice in practices:
    print(practice["ID"], practice["PracticeName"])

client.practices.get#

read
async get(practice_id=None, *, practice_name=None, fields=None) -> dict | None

Fetch 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.

Parameters
ParameterTypeDescription
practice_idint | str | NonePractice ID. Required unless practice_name is given.
practice_namestr | NonePractice name to match.
fieldsIterable[str] | Mapping[str, bool] | NoneOptional field selector.
Returnsdict[str, Any] | None
Raises ValueError when both practice_id and practice_name are omitted.

client.practices.resolve#

read
async resolve(*, practice_id=None, practice_name=None) -> dict

Resolve a practice and return a normalized identifier block. Raises TebraNotFoundError when the practice cannot be found. Also refreshes the ID → name cache.

Parameters
ParameterTypeDescription
practice_idint | str | NonePractice ID to resolve.
practice_namestr | NonePractice name to resolve.
Returnsdict with PracticeID (int when numeric), PracticeName, NPI, and Active.
Example
info = await client.practices.resolve(practice_name="Becki Lentz Physical Therapy, Inc")
print(info["PracticeID"], info["PracticeName"])

client.practices.resolve_name#

read
async resolve_name(*, practice_id=None, practice_name=None) -> str | None

Return 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.

Returnsstr | None
Practice ID supportThis is what makes practice_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",
)

Related