Ttebra_soap_apiAsync Tebra SOAP 2.1
SOAP 2.1
Resources

Charges

Query billing charges without worrying about Tebra's server-side 60-day query limit.

Resource
client.charges
SOAP operation
GetCharges
Flat method
get_charges
Writes
None
On this page

Methods

client.charges.list#

read
async list(*, practice_name=None, practice_id=None, patient_name=None, from_service_date=None, to_service_date=None, from_posting_date=None, to_posting_date=None, from_created_date=None, to_created_date=None, from_last_modified_date=None, to_last_modified_date=None, procedure_code=None, diagnosis_code=None, encounter_status=None, status=None, batch_number=None, billed_to=None, case_payer_scenario=None, rendering_provider_full_name=None, referring_provider_full_name=None, scheduling_provider_full_name=None, service_location_name=None, include_unapproved_charges=None, auto_chunk_days=60, fields=None, extra_filter=None) -> list[dict]

Query billing charges using GetCharges. When both service dates are supplied and span more than auto_chunk_days days (default 60), the wrapper splits the range into contiguous windows, queries each one, and deduplicates the merged rows by charge ID. Set auto_chunk_days=None to send a single request.

Parameters
ParameterTypeDescription
practice_namestr | NonePractice name filter.
practice_idint | str | NonePractice ID; resolved to PracticeName.
patient_namestr | NonePatient name filter.
from_service_datestr | date | datetime | NoneLower service date.
to_service_datestr | date | datetime | NoneUpper service date.
from_posting_datestr | date | datetime | NoneLower posting date.
to_posting_datestr | date | datetime | NoneUpper posting date.
from_created_datestr | date | datetime | NoneLower creation-date bound.
to_created_datestr | date | datetime | NoneUpper creation-date bound.
from_last_modified_datestr | date | datetime | NoneLower last-modified bound.
to_last_modified_datestr | date | datetime | NoneUpper last-modified bound.
procedure_codestr | NoneCPT/HCPCS procedure code.
diagnosis_codestr | NoneDiagnosis code.
encounter_statusstr | NoneEncounter status filter.
statusstr | NoneCharge status filter.
batch_numberstr | NoneBatch number filter.
billed_tostr | NoneBilled-to filter.
case_payer_scenariostr | NoneCase payer scenario filter.
rendering_provider_full_namestr | NoneRendering provider name.
referring_provider_full_namestr | NoneReferring provider name.
scheduling_provider_full_namestr | NoneScheduling provider name.
service_location_namestr | NoneService location name.
include_unapproved_chargesbool | str | NoneInclude unapproved charges. Booleans become true/false.
auto_chunk_daysint | NoneMaximum inclusive window size. Default 60; None disables chunking.
fieldsIterable[str] | Mapping[str, bool] | NoneField selector.
extra_filterMapping[str, Any] | NoneAdditional raw Filter keys applied to every window.
Returnslist[dict[str, Any]] deduplicated by ID when chunked.
Example
# A 106-day range is split into <=60-day windows automatically.
charges = await client.get_charges(
    practice_id=7,
    from_service_date="2026-01-01",
    to_service_date="2026-04-16",
)

# Disable chunking explicitly
raw = await client.charges.list(
    practice_id=7,
    from_service_date="2026-01-01",
    to_service_date="2026-04-16",
    auto_chunk_days=None,
)

Automatic windowing

Normalize both datesAccepts date, datetime, or string formats.
Split into windowsUses chunk_date_range with at most 60 inclusive days per window.
Query sequentiallyEach window is fetched through the normal throttled path.
Merge and deduplicateRows are merged and deduplicated by charge ID.
Filters apply to every windowAll other filters (patient_name, procedure_code, provider names, and so on) are forwarded unchanged to every window.
from tebra_soap_api.utils import chunk_date_range

# The same helper the resource uses
windows = chunk_date_range("2026-01-01", "2026-03-15", max_days=60)
print(windows)  # [("2026-01-01", "2026-03-01"), ("2026-03-02", "2026-03-15")]

Related