> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.taigabilling.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.taigabilling.com/_mcp/server. # Pre Encounter Organization External Providers V 1 Scan GET https://api.taigabilling.com/organization-external-providers/v1/updates/scan Scans up to 1000 organization external provider updates. The since query parameter is inclusive, and the result list is ordered by updatedAt ascending. **Polling Pattern:** To continuously poll for updates without gaps: 1. Make your initial request with a `since` timestamp (e.g., `since=2020-01-01T13:00:00.000Z`) 2. The API returns 100 by default and up to 1000 records, sorted by `updated_at` ascending 3. Find the `updated_at` value from the last record in the response 4. Use that `updated_at` value as the `since` parameter in your next request 5. Repeat steps 2-4 to ingest updates until you receive an empty list **Important Notes:** - The `since` parameter is inclusive, so you may receive the last record from the previous batch again (you can deduplicate by ID and version) - All records include `updated_at`, `id`, `version`, `deactivated`, and `updating_user` fields for tracking changes - Timestamps have millisecond resolution for precise ordering Reference: https://docs.taigabilling.com/api-reference/pre-encounter-organization-external-providers-v-1/pre-encounter-organization-external-providers-v-1-scan ## Authentication - `Authorization` header (bearer token, required) — Send your Taiga API key as a Bearer token. Create and manage keys in the Taiga developer portal. ## Servers - `https://api.taigabilling.com` (Production, default) - `https://api-staging.taigabilling.com` (Staging) ## Request ### Query parameters - `since` (datetime, required) - `maxResults` (integer, optional) ## Response ### 200 - `list of pre-encounterorganizationExternalProvidersv1OrganizationExternalProvider` ## Types ### pre-encounterorganizationExternalProvidersv1OrganizationExternalProvider An OrganizationExternalProvider object with immutable server-owned properties. - `deactivated` (boolean, required) — True if the object is deactivated. Deactivated objects are not returned in search results but are returned in all other endpoints including scan. - `id` (string, required) — The unique identifier for an OrganizationExternalProvider in the database - `name` (pre-encounterHumanName, required) - `organization_id` (string, required) — The organization that owns this object. - `types` (list of enum, required) - Allowed values: `REFERRING`, `PRIMARY`, `TREATING` - `updated_at` (datetime, required) - `updating_user_id` (string, required) — The user ID of the user who last updated the object. - `version` (integer, required) — The version of the object. Any update to any property of an object object will create a new version. - `addresses` (list of pre-encounterAddress, optional, nullable) - `emails` (list of string, optional, nullable) - `fax_number` (string, optional, nullable) - `license_type` (enum, optional, nullable) - Allowed values: `MD`, `NP`, `PA`, `LMFT`, `LCPC`, `LCSW`, `PMHNP`, `FNP`, `LPCC`, `DO`, `RD`, `SLP`, `APRN`, `LPC`, `PHD`, `PSYD`, `LMSW`, `LMHC`, `OTHER_MASTERS`, `BCBA`, `UNKNOWN`, `RPH`, `PHT`, `LAC`, `LMT`, `DC`, `ND`, `MA`, `PT`, `IBCLC`, `RN`, `DPT`, `LCMHC`, `CNM`, `RNFA`, `ACSW`, `APC`, `BCABA`, `BHA`, `OD`, `DPM`, `DA`, `DDS`, `DEH`, `DMD`, `PTA`, `LCADC`, `LCAT`, `LCMHCS`, `LCMHCA`, `LCSWA`, `LICSW`, `LISW`, `LMFTS`, `LMFTA`, `LPCI`, `LSCSW`, `MHCA`, `MHT`, `RBT`, `RCSWI`, `RHMCI`, `LPN`, `OTD`, `OMS`, `MFTA`, `APCC`, `DNP`, `AGNPBC`, `ANP`, `FNPPP`, `LCSWR`, `ALC`, `RMFTI`, `LAMFT`, `LPCA`, `LSWI`, `CSW`, `CPC`, `LGMFT`, `LLPC`, `PLPC`, `PLMFT`, `LMHCA`, `CIT`, `CT`, `MFT`, `LSW`, `PLMHP`, `PCMSW`, `LMHP`, `OTR/L`, `RPA`, `COTA`, `CRNP`, `SLP-CF`, `NP-C`, `PA-C`, `AMFT`, `CDN`, `CGC`, `CNS`, `MDPHD`, `AuD`, `ATC`, `LAT`, `OTA`, `LSSP`, `SLPA` - `npi` (string, optional, nullable) - `other_fax_numbers` (list of string, optional, nullable) - `other_phone_numbers` (list of string, optional, nullable) - `phone_number` (string, optional, nullable) - `tax_id` (string, optional, nullable) - `taxonomy_code` (string, optional, nullable) ### pre-encounterHumanName - `family` (string, required) - `given` (list of string, required) - `use` (enum, required) - Allowed values: `USUAL`, `OFFICIAL`, `TEMP`, `NICKNAME`, `ANONYMOUS`, `OLD`, `MAIDEN` - `period` (pre-encounterPeriod, optional, nullable) - `suffix` (string, optional, nullable) ### pre-encounterAddress - `use` (enum, required) - Allowed values: `HOME`, `WORK`, `TEMP`, `OLD`, `BILLING` - `line` (list of string, required) - `city` (string, required) - `state` (string, required) - `postal_code` (string, required) - `country` (string, required) - `administrative_area` (string, optional, nullable) — The top-level administrative subdivision of the country for addresses outside the US — for example a Canadian province, a UK county, or a Japanese prefecture. Only permitted on international addresses: `country` must be present and non-US, and `state` must be "FC" (the X12 foreign-country sentinel). For US addresses use `state` instead. - `county` (string, optional, nullable) - `period` (pre-encounterPeriod, optional, nullable) ### pre-encounterPeriod - `start` (date, optional, nullable) - `end` (date, optional, nullable) ## Examples **Response** ```json [ { "deactivated": true, "id": "string", "name": { "family": "string", "given": [ "string" ], "use": "USUAL", "period": { "start": "2023-01-15", "end": "2023-01-15" }, "suffix": "string" }, "organization_id": "string", "types": [ "REFERRING" ], "updated_at": "2024-01-15T09:30:00Z", "updating_user_id": "string", "version": 1, "addresses": [ { "use": "HOME", "line": [ "string" ], "city": "string", "state": "string", "postal_code": "string", "country": "string", "administrative_area": "string", "county": "string", "period": { "start": "2023-01-15", "end": "2023-01-15" } } ], "emails": [ "string" ], "fax_number": "string", "license_type": "MD", "npi": "string", "other_fax_numbers": [ "string" ], "other_phone_numbers": [ "string" ], "phone_number": "string", "tax_id": "string", "taxonomy_code": "string" } ] ``` **SDK Code** ```python import requests url = "https://api.taigabilling.com/organization-external-providers/v1/updates/scan" querystring = {"since":"since"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ```