@healthcloudai/hc-sdk 3.7.0 → 3.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (35) hide show
  1. package/dist/index.cjs +51 -0
  2. package/dist/index.d.cts +784 -369
  3. package/dist/index.d.ts +784 -369
  4. package/dist/index.js +51 -0
  5. package/docs/clients/ProviderClient.md +8 -0
  6. package/docs/docs-manifest.json +26 -3
  7. package/docs/examples/index.md +8 -0
  8. package/docs/index.md +8 -0
  9. package/docs/models/ProviderAppointment.md +24 -0
  10. package/docs/models/ProviderAppointmentResponse.md +17 -0
  11. package/docs/models/ProviderAppointmentsResponse.md +18 -0
  12. package/docs/models/ProviderEncounterListResponse.md +18 -0
  13. package/docs/models/ProviderEncounterResponse.md +17 -0
  14. package/docs/models/ProviderPatientAddress.md +22 -0
  15. package/docs/models/ProviderPatientPhone.md +19 -0
  16. package/docs/models/ProviderPatientRecordResponse.md +24 -0
  17. package/docs/models/ProviderPatientSummary.md +27 -0
  18. package/docs/models/UpdateEncounterClinicalNoteRequest.md +24 -0
  19. package/docs/models/UpdateEncounterClinicalNoteResponse.md +19 -0
  20. package/docs/models/UpdateEncounterStatusRequest.md +21 -0
  21. package/docs/models/UpdateEncounterStatusResponse.md +19 -0
  22. package/docs/models/index.md +15 -0
  23. package/docs/models/provider.LoginResponse.md +1 -0
  24. package/docs/models/provider.RefreshTokenRequest.md +18 -0
  25. package/docs/models/provider.RefreshTokenResponse.md +21 -0
  26. package/docs/operations/provider.getAppointment.md +148 -0
  27. package/docs/operations/provider.getEncounter.md +120 -0
  28. package/docs/operations/provider.getPatientRecord.md +122 -0
  29. package/docs/operations/provider.listAppointments.md +176 -0
  30. package/docs/operations/provider.listEncounters.md +123 -0
  31. package/docs/operations/provider.login.md +7 -6
  32. package/docs/operations/provider.refreshToken.md +115 -0
  33. package/docs/operations/provider.updateEncounterClinicalNote.md +154 -0
  34. package/docs/operations/provider.updateEncounterStatus.md +152 -0
  35. package/package.json +1 -1
package/dist/index.js CHANGED
@@ -2866,6 +2866,50 @@ var ProviderClient = class extends BaseServiceClient {
2866
2866
  connect() {
2867
2867
  return this.connectService();
2868
2868
  }
2869
+ /** List encounters in the authenticated provider's tenant. */
2870
+ listEncounters(filters) {
2871
+ return this.send("GET", "/encounters", { query: filters });
2872
+ }
2873
+ /** Get one encounter with its patient demographic summary. */
2874
+ getEncounter(encounterId) {
2875
+ return this.send("GET", "/encounters/{encounter_id}", { pathParams: { encounter_id: encounterId } });
2876
+ }
2877
+ /** Update the clinical note and assessment for one encounter. */
2878
+ updateEncounterClinicalNote(encounterId, request) {
2879
+ return this.send("PATCH", "/encounters/{encounter_id}/clinical-note", {
2880
+ pathParams: { encounter_id: encounterId },
2881
+ body: request
2882
+ });
2883
+ }
2884
+ /** Update canonical status; the server resolves any EHR status ID. */
2885
+ updateEncounterStatus(encounterId, request) {
2886
+ return this.send("PATCH", "/encounters/{encounter_id}/status", {
2887
+ pathParams: { encounter_id: encounterId },
2888
+ body: request
2889
+ });
2890
+ }
2891
+ /** List appointments in the authenticated provider's tenant.
2892
+ *
2893
+ * Date-window semantics (identical on the Athena and FHIR backends):
2894
+ * neither date -> today .. today+30d; only start_date -> start_date .. start_date+30d;
2895
+ * only end_date -> today .. end_date; legacy date pins exactly one calendar day.
2896
+ * The window is capped at 90 days and the result count at limit (default 100, max 200).
2897
+ */
2898
+ listAppointments(filters) {
2899
+ return this.send("GET", "/appointments", { query: filters });
2900
+ }
2901
+ /** Get one appointment with its patient demographic summary. */
2902
+ getAppointment(appointmentId) {
2903
+ return this.send("GET", "/appointments/{appointment_id}", { pathParams: { appointment_id: appointmentId } });
2904
+ }
2905
+ /** Get a patient's consolidated health record (provider tenant scope). */
2906
+ getPatientRecord(patientId) {
2907
+ return this.send("GET", "/patients/{patient_id}/record", { pathParams: { patient_id: patientId } });
2908
+ }
2909
+ /** @deprecated Use listAppointments({ visit_type: "telehealth" }). */
2910
+ listTelehealthAppointments(filters) {
2911
+ return this.listAppointments({ ...filters, visit_type: "telehealth" });
2912
+ }
2869
2913
  /** Submit multiple insurance eligibility checks for asynchronous processing. */
2870
2914
  async submitInsuranceEligibilityBatch(request) {
2871
2915
  const response = await this.send("POST", "/insurance/eligibility/batch", {
@@ -2880,6 +2924,13 @@ var ProviderClient = class extends BaseServiceClient {
2880
2924
  login(request) {
2881
2925
  return this.send("POST", "/auth/login", { body: withTenantId(request, this.getTenantId()), auth: false });
2882
2926
  }
2927
+ /**
2928
+ * Renew practitioner tokens via Cognito REFRESH_TOKEN_AUTH (POST /auth/refresh).
2929
+ * Requires a refresh token previously returned by login.
2930
+ */
2931
+ refreshToken(request) {
2932
+ return this.send("POST", "/auth/refresh", { body: withTenantId(request, this.getTenantId()), auth: false });
2933
+ }
2883
2934
  verifyEmail(request) {
2884
2935
  return this.send("POST", "/auth/verify-email", { body: withTenantId(request, this.getTenantId()), auth: false });
2885
2936
  }
@@ -2,13 +2,21 @@
2
2
 
3
3
  - [`confirmPassword`](../operations/provider.confirmResetPassword.md) — Complete a password reset
4
4
  - [`connect`](../operations/provider.connect.md) — Health check
5
+ - [`getAppointment`](../operations/provider.getAppointment.md) — Get one appointment with patient demographics
6
+ - [`getEncounter`](../operations/provider.getEncounter.md) — Get one encounter with patient demographics
7
+ - [`getPatientRecord`](../operations/provider.getPatientRecord.md) — Get a patient's consolidated health record (provider tenant scope)
5
8
  - [`getPhoto`](../operations/provider.getPhoto.md) — Get a practitioner photo
6
9
  - [`getPhotoUploadUrl`](../operations/provider.getPhotoUploadUrl.md) — Get a presigned photo upload URL
7
10
  - [`get`](../operations/provider.getPractitioner.md) — Get a practitioner profile
11
+ - [`listAppointments`](../operations/provider.listAppointments.md) — List tenant appointments
12
+ - [`listEncounters`](../operations/provider.listEncounters.md) — List tenant encounters
8
13
  - [`login`](../operations/provider.login.md) — Log in a practitioner
14
+ - [`refreshToken`](../operations/provider.refreshToken.md) — Refresh practitioner access tokens
9
15
  - [`register`](../operations/provider.register.md) — Register a practitioner
10
16
  - [`resetPassword`](../operations/provider.resetPassword.md) — Start a password reset
11
17
  - [`submitInsuranceEligibilityBatch`](../operations/provider.submitInsuranceEligibilityBatch.md) — Submit multiple insurance eligibility checks
18
+ - [`updateEncounterClinicalNote`](../operations/provider.updateEncounterClinicalNote.md) — Update encounter notes and assessment
19
+ - [`updateEncounterStatus`](../operations/provider.updateEncounterStatus.md) — Update encounter status
12
20
  - [`updatePhone`](../operations/provider.updatePhone.md) — Update a practitioner's phone number
13
21
  - [`update`](../operations/provider.updatePractitioner.md) — Update a practitioner profile
14
22
  - [`uploadPhoto`](../operations/provider.uploadPhoto.md) — Upload a practitioner photo
@@ -1,5 +1,5 @@
1
1
  {
2
- "docsDataContentDigest": "sha256:4493f6fb92c1eb8be63e575757907abe3b87008445a51ab20d54a2d4706709ec",
2
+ "docsDataContentDigest": "sha256:c086ded1f04ab6be9d24f46bef26ef7bb50a4bd20ae767021dff76745405a358",
3
3
  "generatedFiles": [
4
4
  "authentication.md",
5
5
  "clients/AmsClient.md",
@@ -1373,12 +1373,21 @@
1373
1373
  "models/ProcedureLaterality.md",
1374
1374
  "models/ProcedureStatus.md",
1375
1375
  "models/ProviderAcceptedInsurance.md",
1376
+ "models/ProviderAppointment.md",
1377
+ "models/ProviderAppointmentResponse.md",
1378
+ "models/ProviderAppointmentsResponse.md",
1376
1379
  "models/ProviderContactPoint.md",
1377
1380
  "models/ProviderEducationCredential.md",
1381
+ "models/ProviderEncounterListResponse.md",
1382
+ "models/ProviderEncounterResponse.md",
1378
1383
  "models/ProviderGender.md",
1379
1384
  "models/ProviderIdentifier.md",
1380
1385
  "models/ProviderIdentifierType.md",
1381
1386
  "models/ProviderLanguage.md",
1387
+ "models/ProviderPatientAddress.md",
1388
+ "models/ProviderPatientPhone.md",
1389
+ "models/ProviderPatientRecordResponse.md",
1390
+ "models/ProviderPatientSummary.md",
1382
1391
  "models/ProviderRole.md",
1383
1392
  "models/ProviderSearchRequest.md",
1384
1393
  "models/ProviderSearchResponse.md",
@@ -1776,6 +1785,10 @@
1776
1785
  "models/UpdateDemographicsResponse.md",
1777
1786
  "models/UpdateDriversLicenseRequest.md",
1778
1787
  "models/UpdateDriversLicenseResponse.md",
1788
+ "models/UpdateEncounterClinicalNoteRequest.md",
1789
+ "models/UpdateEncounterClinicalNoteResponse.md",
1790
+ "models/UpdateEncounterStatusRequest.md",
1791
+ "models/UpdateEncounterStatusResponse.md",
1779
1792
  "models/UpdateMedicationRequest.md",
1780
1793
  "models/UpdateMedicationResponse.md",
1781
1794
  "models/UpdatePatientAttributesRequest.md",
@@ -2047,6 +2060,8 @@
2047
2060
  "models/provider.GetPhotoUploadUrlResponse.md",
2048
2061
  "models/provider.LoginRequest.md",
2049
2062
  "models/provider.LoginResponse.md",
2063
+ "models/provider.RefreshTokenRequest.md",
2064
+ "models/provider.RefreshTokenResponse.md",
2050
2065
  "models/provider.RegisterRequest.md",
2051
2066
  "models/provider.RegisterResponse.md",
2052
2067
  "models/provider.ResetPasswordRequest.md",
@@ -3060,13 +3075,21 @@
3060
3075
  "operations/person.verifySms.md",
3061
3076
  "operations/provider.confirmResetPassword.md",
3062
3077
  "operations/provider.connect.md",
3078
+ "operations/provider.getAppointment.md",
3079
+ "operations/provider.getEncounter.md",
3080
+ "operations/provider.getPatientRecord.md",
3063
3081
  "operations/provider.getPhoto.md",
3064
3082
  "operations/provider.getPhotoUploadUrl.md",
3065
3083
  "operations/provider.getPractitioner.md",
3084
+ "operations/provider.listAppointments.md",
3085
+ "operations/provider.listEncounters.md",
3066
3086
  "operations/provider.login.md",
3087
+ "operations/provider.refreshToken.md",
3067
3088
  "operations/provider.register.md",
3068
3089
  "operations/provider.resetPassword.md",
3069
3090
  "operations/provider.submitInsuranceEligibilityBatch.md",
3091
+ "operations/provider.updateEncounterClinicalNote.md",
3092
+ "operations/provider.updateEncounterStatus.md",
3070
3093
  "operations/provider.updatePhone.md",
3071
3094
  "operations/provider.updatePractitioner.md",
3072
3095
  "operations/provider.uploadPhoto.md",
@@ -3083,7 +3106,7 @@
3083
3106
  "operations/vitals.recordVitals.md"
3084
3107
  ],
3085
3108
  "language": "nodejs",
3086
- "modelCount": 2009,
3087
- "operationCount": 1017,
3109
+ "modelCount": 2024,
3110
+ "operationCount": 1025,
3088
3111
  "schemaVersion": 1
3089
3112
  }
@@ -998,13 +998,21 @@ Generated call examples use exact public surface signatures. Workflow examples r
998
998
  - [Verify a person's phone OTP](../operations/person.verifySms.md)
999
999
  - [Complete a password reset](../operations/provider.confirmResetPassword.md)
1000
1000
  - [Health check](../operations/provider.connect.md)
1001
+ - [Get one appointment with patient demographics](../operations/provider.getAppointment.md)
1002
+ - [Get one encounter with patient demographics](../operations/provider.getEncounter.md)
1003
+ - [Get a patient's consolidated health record (provider tenant scope)](../operations/provider.getPatientRecord.md)
1001
1004
  - [Get a practitioner photo](../operations/provider.getPhoto.md)
1002
1005
  - [Get a presigned photo upload URL](../operations/provider.getPhotoUploadUrl.md)
1003
1006
  - [Get a practitioner profile](../operations/provider.getPractitioner.md)
1007
+ - [List tenant appointments](../operations/provider.listAppointments.md)
1008
+ - [List tenant encounters](../operations/provider.listEncounters.md)
1004
1009
  - [Log in a practitioner](../operations/provider.login.md)
1010
+ - [Refresh practitioner access tokens](../operations/provider.refreshToken.md)
1005
1011
  - [Register a practitioner](../operations/provider.register.md)
1006
1012
  - [Start a password reset](../operations/provider.resetPassword.md)
1007
1013
  - [Submit multiple insurance eligibility checks](../operations/provider.submitInsuranceEligibilityBatch.md)
1014
+ - [Update encounter notes and assessment](../operations/provider.updateEncounterClinicalNote.md)
1015
+ - [Update encounter status](../operations/provider.updateEncounterStatus.md)
1008
1016
  - [Update a practitioner's phone number](../operations/provider.updatePhone.md)
1009
1017
  - [Update a practitioner profile](../operations/provider.updatePractitioner.md)
1010
1018
  - [Upload a practitioner photo](../operations/provider.uploadPhoto.md)
package/docs/index.md CHANGED
@@ -1006,13 +1006,21 @@ This directory is generated from the shared structured docs data. Do not edit ge
1006
1006
  - [Verify a person's phone OTP](operations/person.verifySms.md) (`person.verifySms`)
1007
1007
  - [Complete a password reset](operations/provider.confirmResetPassword.md) (`provider.confirmResetPassword`)
1008
1008
  - [Health check](operations/provider.connect.md) (`provider.connect`)
1009
+ - [Get one appointment with patient demographics](operations/provider.getAppointment.md) (`provider.getAppointment`)
1010
+ - [Get one encounter with patient demographics](operations/provider.getEncounter.md) (`provider.getEncounter`)
1011
+ - [Get a patient's consolidated health record (provider tenant scope)](operations/provider.getPatientRecord.md) (`provider.getPatientRecord`)
1009
1012
  - [Get a practitioner photo](operations/provider.getPhoto.md) (`provider.getPhoto`)
1010
1013
  - [Get a presigned photo upload URL](operations/provider.getPhotoUploadUrl.md) (`provider.getPhotoUploadUrl`)
1011
1014
  - [Get a practitioner profile](operations/provider.getPractitioner.md) (`provider.getPractitioner`)
1015
+ - [List tenant appointments](operations/provider.listAppointments.md) (`provider.listAppointments`)
1016
+ - [List tenant encounters](operations/provider.listEncounters.md) (`provider.listEncounters`)
1012
1017
  - [Log in a practitioner](operations/provider.login.md) (`provider.login`)
1018
+ - [Refresh practitioner access tokens](operations/provider.refreshToken.md) (`provider.refreshToken`)
1013
1019
  - [Register a practitioner](operations/provider.register.md) (`provider.register`)
1014
1020
  - [Start a password reset](operations/provider.resetPassword.md) (`provider.resetPassword`)
1015
1021
  - [Submit multiple insurance eligibility checks](operations/provider.submitInsuranceEligibilityBatch.md) (`provider.submitInsuranceEligibilityBatch`)
1022
+ - [Update encounter notes and assessment](operations/provider.updateEncounterClinicalNote.md) (`provider.updateEncounterClinicalNote`)
1023
+ - [Update encounter status](operations/provider.updateEncounterStatus.md) (`provider.updateEncounterStatus`)
1016
1024
  - [Update a practitioner's phone number](operations/provider.updatePhone.md) (`provider.updatePhone`)
1017
1025
  - [Update a practitioner profile](operations/provider.updatePractitioner.md) (`provider.updatePractitioner`)
1018
1026
  - [Upload a practitioner photo](operations/provider.uploadPhoto.md) (`provider.uploadPhoto`)
@@ -0,0 +1,24 @@
1
+ # ProviderAppointment
2
+
3
+ Model ID: `ProviderAppointment`
4
+
5
+ Source-neutral appointment returned to a provider.
6
+
7
+ Type: `object`
8
+
9
+ ## Fields
10
+
11
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
12
+ |---|---|---:|---|---|---|---:|---|
13
+ | `appointment_id` | `string` | Yes | | | | No | Stable appointment identifier; Athena-authoritative tenants return Athena's native appointment ID. |
14
+ | `end` | `string|null` | No | | | | Yes | Appointment end in ISO 8601 date-time format. |
15
+ | `patient` | [`ProviderPatientSummary`](./ProviderPatientSummary.md) | No | | | | Yes | Demographic snapshot (first/last name, gender, DOB, address, phone) of the associated patient. On list responses, only the first 20 items carry a summary; by-ID responses always include it when readable. |
16
+ | `patient_id` | `string` | Yes | | | | No | FHIR Patient resource ID associated with the appointment. |
17
+ | `provider_id` | `string|null` | No | | | | Yes | FHIR Practitioner resource ID, when available. |
18
+ | `start` | `string|null` | No | | | | Yes | Appointment start in ISO 8601 date-time format. |
19
+ | `status` | `string` | Yes | | scheduled, confirmed, cancelled, completed, no_show | | No | Normalized appointment lifecycle status. |
20
+ | `telehealth_link` | `string|null` | No | | | | Yes | Video-visit link, when one has been created for this appointment. |
21
+
22
+ ## Example
23
+
24
+ None declared in canonical OpenAPI.
@@ -0,0 +1,17 @@
1
+ # ProviderAppointmentResponse
2
+
3
+ Model ID: `ProviderAppointmentResponse`
4
+
5
+ One appointment returned to an authenticated provider.
6
+
7
+ Type: `object`
8
+
9
+ ## Fields
10
+
11
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
12
+ |---|---|---:|---|---|---|---:|---|
13
+ | `appointment` | [`ProviderAppointment`](./ProviderAppointment.md) | Yes | | | | No | The requested appointment, including its patient demographic summary. |
14
+
15
+ ## Example
16
+
17
+ None declared in canonical OpenAPI.
@@ -0,0 +1,18 @@
1
+ # ProviderAppointmentsResponse
2
+
3
+ Model ID: `ProviderAppointmentsResponse`
4
+
5
+ Tenant appointments in one HealthCloud shape.
6
+
7
+ Type: `object`
8
+
9
+ ## Fields
10
+
11
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
12
+ |---|---|---:|---|---|---|---:|---|
13
+ | `appointments` | array of [`ProviderAppointment`](./ProviderAppointment.md) | Yes | | | | No | Appointments for the requested filters; the first 20 items include a patient demographic summary when the tenant's FHIR Patient record is readable. |
14
+ | `total` | `integer` | Yes | | | | No | Number of appointments returned. |
15
+
16
+ ## Example
17
+
18
+ None declared in canonical OpenAPI.
@@ -0,0 +1,18 @@
1
+ # ProviderEncounterListResponse
2
+
3
+ Model ID: `ProviderEncounterListResponse`
4
+
5
+ Tenant-scoped encounter list returned to an authenticated provider.
6
+
7
+ Type: `object`
8
+
9
+ ## Fields
10
+
11
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
12
+ |---|---|---:|---|---|---|---:|---|
13
+ | `encounters` | `array` | Yes | | | | No | FHIR-backed encounter records in the caller's tenant; the first 20 items also carry a patient demographic summary under the 'patient' key when the tenant's FHIR Patient record is readable. |
14
+ | `total` | `integer` | Yes | | | | No | Number of encounter records returned. |
15
+
16
+ ## Example
17
+
18
+ None declared in canonical OpenAPI.
@@ -0,0 +1,17 @@
1
+ # ProviderEncounterResponse
2
+
3
+ Model ID: `ProviderEncounterResponse`
4
+
5
+ One encounter returned to an authenticated provider.
6
+
7
+ Type: `object`
8
+
9
+ ## Fields
10
+
11
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
12
+ |---|---|---:|---|---|---|---:|---|
13
+ | `encounter` | `object` | Yes | | | | No | FHIR-backed encounter record with a patient demographic summary under the 'patient' key when the tenant's FHIR Patient record is readable. |
14
+
15
+ ## Example
16
+
17
+ None declared in canonical OpenAPI.
@@ -0,0 +1,22 @@
1
+ # ProviderPatientAddress
2
+
3
+ Model ID: `ProviderPatientAddress`
4
+
5
+ Primary address snapshot returned inside a provider patient summary.
6
+
7
+ Type: `object`
8
+
9
+ ## Fields
10
+
11
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
12
+ |---|---|---:|---|---|---|---:|---|
13
+ | `city` | `string|null` | No | | | | Yes | City in the address. |
14
+ | `country` | `string|null` | No | | | | Yes | ISO 3166-1 alpha-2 country code. |
15
+ | `state` | `string|null` | No | | | | Yes | 2-letter US state code. |
16
+ | `street1` | `string|null` | No | | | | Yes | First address line (street number and name). |
17
+ | `street2` | `string|null` | No | | | | Yes | Second address line (apartment, suite, unit), when present. |
18
+ | `zip_code` | `string|null` | No | | | | Yes | US ZIP code (5 or 9 digits). |
19
+
20
+ ## Example
21
+
22
+ None declared in canonical OpenAPI.
@@ -0,0 +1,19 @@
1
+ # ProviderPatientPhone
2
+
3
+ Model ID: `ProviderPatientPhone`
4
+
5
+ Primary phone snapshot returned inside a provider patient summary.
6
+
7
+ Type: `object`
8
+
9
+ ## Fields
10
+
11
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
12
+ |---|---|---:|---|---|---|---:|---|
13
+ | `extension` | `string|null` | No | | | | Yes | Phone extension, when present. |
14
+ | `number` | `string|null` | No | | | | Yes | Phone number in E.164 or 10-15 digit format. |
15
+ | `type` | `string|null` | No | | | | Yes | Phone use: mobile, home, or work. |
16
+
17
+ ## Example
18
+
19
+ None declared in canonical OpenAPI.
@@ -0,0 +1,24 @@
1
+ # ProviderPatientRecordResponse
2
+
3
+ Model ID: `ProviderPatientRecordResponse`
4
+
5
+ Consolidated health record for one patient in the provider's own tenant.
6
+
7
+ Mirrors the shape of the patient-facing EHR health-record response so
8
+ provider clients see the same section keys and serialized domain models.
9
+ A patient that does not exist in the caller's tenant resolves to 404
10
+ before this response is produced.
11
+
12
+ Type: `object`
13
+
14
+ ## Fields
15
+
16
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
17
+ |---|---|---:|---|---|---|---:|---|
18
+ | `patient_id` | `string` | Yes | | | | No | Echoes the {patient_id} path parameter. |
19
+ | `resources` | `object` | Yes | | | | No | Resources grouped by type (conditions, allergies, medications, procedures, immunizations, family_history, consents, social_history, functional_status, gyn_history, perinatal_history, encounters, vitals, questionnaire_responses, diagnostics, intake_submissions) — every section is a serialized domain model, never a raw FHIR resource. Vitals is the latest-reading VitalsRecord summary per LOINC code. A resource type with a failed downstream fetch appears as an empty list, not an error. |
20
+ | `totals` | `object` | Yes | | | | No | Count of records per resource type key in `resources`. |
21
+
22
+ ## Example
23
+
24
+ None declared in canonical OpenAPI.
@@ -0,0 +1,27 @@
1
+ # ProviderPatientSummary
2
+
3
+ Model ID: `ProviderPatientSummary`
4
+
5
+ Demographic snapshot attached to appointments and encounters.
6
+
7
+ Built from the tenant's own FHIR Patient record; when the patient record
8
+ cannot be read, the summary is omitted rather than failing the whole
9
+ request.
10
+
11
+ Type: `object`
12
+
13
+ ## Fields
14
+
15
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
16
+ |---|---|---:|---|---|---|---:|---|
17
+ | `address` | [`ProviderPatientAddress`](./ProviderPatientAddress.md) | No | | | | Yes | Patient's primary address, when recorded. |
18
+ | `date_of_birth` | `string|null` | No | | | | Yes | Patient's date of birth in ISO date format. |
19
+ | `first_name` | `string|null` | No | | | | Yes | Patient's first (given) name. |
20
+ | `gender` | `string|null` | No | | | | Yes | Administrative gender: male, female, other, or unknown. |
21
+ | `last_name` | `string|null` | No | | | | Yes | Patient's last (family) name. |
22
+ | `patient_id` | `string` | Yes | | | | No | FHIR Patient resource ID. |
23
+ | `phone` | [`ProviderPatientPhone`](./ProviderPatientPhone.md) | No | | | | Yes | Patient's primary phone number, when recorded. |
24
+
25
+ ## Example
26
+
27
+ None declared in canonical OpenAPI.
@@ -0,0 +1,24 @@
1
+ # UpdateEncounterClinicalNoteRequest
2
+
3
+ Model ID: `UpdateEncounterClinicalNoteRequest`
4
+
5
+ FHIR notes and/or clinical assessment for one encounter.
6
+
7
+ The FHIR Encounter stores the submitted content in its notes extension.
8
+ When the encounter is linked to the configured EHR, ``notes`` is written
9
+ to the EHR SOAP subjective field and ``assessment`` to its SOAP assessment
10
+ field. At least one field must be supplied; the handler enforces that
11
+ cross-field rule.
12
+
13
+ Type: `object`
14
+
15
+ ## Fields
16
+
17
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
18
+ |---|---|---:|---|---|---|---:|---|
19
+ | `assessment` | `string|null` | No | | | | Yes | Clinical assessment; mirrored to the linked EHR SOAP assessment field when available. |
20
+ | `notes` | `string|null` | No | | | | Yes | Encounter notes; mirrored to the linked EHR SOAP subjective field when available. |
21
+
22
+ ## Example
23
+
24
+ None declared in canonical OpenAPI.
@@ -0,0 +1,19 @@
1
+ # UpdateEncounterClinicalNoteResponse
2
+
3
+ Model ID: `UpdateEncounterClinicalNoteResponse`
4
+
5
+ Result of a FHIR clinical-note update and conditional EHR mirror.
6
+
7
+ Type: `object`
8
+
9
+ ## Fields
10
+
11
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
12
+ |---|---|---:|---|---|---|---:|---|
13
+ | `ehr_status` | `string` | Yes | | updated, not_linked | | No | Whether a linked EHR encounter was updated too. |
14
+ | `encounter` | `object` | Yes | | | | No | Updated FHIR encounter. |
15
+ | `fhir_status` | `string` | Yes | | | | No | FHIR update completed. |
16
+
17
+ ## Example
18
+
19
+ None declared in canonical OpenAPI.
@@ -0,0 +1,21 @@
1
+ # UpdateEncounterStatusRequest
2
+
3
+ Model ID: `UpdateEncounterStatusRequest`
4
+
5
+ Set one encounter's HealthCloud and configured EHR statuses.
6
+
7
+ The server resolves any vendor-specific status/location IDs from the
8
+ tenant's EHR integration configuration. Provider clients submit only the
9
+ canonical HealthCloud status and never see or store vendor IDs.
10
+
11
+ Type: `object`
12
+
13
+ ## Fields
14
+
15
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
16
+ |---|---|---:|---|---|---|---:|---|
17
+ | `status` | `string` | Yes | | | | No | HealthCloud encounter status to persist in FHIR. |
18
+
19
+ ## Example
20
+
21
+ None declared in canonical OpenAPI.
@@ -0,0 +1,19 @@
1
+ # UpdateEncounterStatusResponse
2
+
3
+ Model ID: `UpdateEncounterStatusResponse`
4
+
5
+ Result of a FHIR encounter-status update and conditional EHR mirror.
6
+
7
+ Type: `object`
8
+
9
+ ## Fields
10
+
11
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
12
+ |---|---|---:|---|---|---|---:|---|
13
+ | `ehr_status` | `string` | Yes | | updated, not_linked, skipped | | No | Whether a linked EHR encounter was updated too. 'skipped' means the encounter is linked but this HealthCloud status has no flow-board equivalent, so only FHIR was updated. |
14
+ | `encounter` | `object` | Yes | | | | No | Updated FHIR encounter. |
15
+ | `fhir_status` | `string` | Yes | | | | No | FHIR update completed. |
16
+
17
+ ## Example
18
+
19
+ None declared in canonical OpenAPI.
@@ -1426,6 +1426,8 @@
1426
1426
  - [PhotoUploadUrlResponse](provider.GetPhotoUploadUrlResponse.md)
1427
1427
  - [ProviderLoginRequest](provider.LoginRequest.md)
1428
1428
  - [ProviderLoginResponse](provider.LoginResponse.md)
1429
+ - [ProviderRefreshTokenRequest](provider.RefreshTokenRequest.md)
1430
+ - [ProviderRefreshTokenResponse](provider.RefreshTokenResponse.md)
1429
1431
  - [ProviderRegisterRequest](provider.RegisterRequest.md)
1430
1432
  - [ProviderRegisterResponse](provider.RegisterResponse.md)
1431
1433
  - [ProviderResetPasswordRequest](provider.ResetPasswordRequest.md)
@@ -1439,12 +1441,21 @@
1439
1441
  - [ProviderVerifySmsRequest](provider.VerifySmsRequest.md)
1440
1442
  - [ProviderVerifySmsResponse](provider.VerifySmsResponse.md)
1441
1443
  - [ProviderAcceptedInsurance](ProviderAcceptedInsurance.md)
1444
+ - [ProviderAppointment](ProviderAppointment.md)
1445
+ - [ProviderAppointmentResponse](ProviderAppointmentResponse.md)
1446
+ - [ProviderAppointmentsResponse](ProviderAppointmentsResponse.md)
1442
1447
  - [ProviderContactPoint](ProviderContactPoint.md)
1443
1448
  - [ProviderEducationCredential](ProviderEducationCredential.md)
1449
+ - [ProviderEncounterListResponse](ProviderEncounterListResponse.md)
1450
+ - [ProviderEncounterResponse](ProviderEncounterResponse.md)
1444
1451
  - [ProviderGender](ProviderGender.md)
1445
1452
  - [ProviderIdentifier](ProviderIdentifier.md)
1446
1453
  - [ProviderIdentifierType](ProviderIdentifierType.md)
1447
1454
  - [ProviderLanguage](ProviderLanguage.md)
1455
+ - [ProviderPatientAddress](ProviderPatientAddress.md)
1456
+ - [ProviderPatientPhone](ProviderPatientPhone.md)
1457
+ - [ProviderPatientRecordResponse](ProviderPatientRecordResponse.md)
1458
+ - [ProviderPatientSummary](ProviderPatientSummary.md)
1448
1459
  - [ProviderRole](ProviderRole.md)
1449
1460
  - [ProviderSearchRequest](ProviderSearchRequest.md)
1450
1461
  - [ProviderSearchResponse](ProviderSearchResponse.md)
@@ -1846,6 +1857,10 @@
1846
1857
  - [UpdateDemographicsResponse](UpdateDemographicsResponse.md)
1847
1858
  - [UpdateDriversLicenseRequest](UpdateDriversLicenseRequest.md)
1848
1859
  - [UpdateDriversLicenseResponse](UpdateDriversLicenseResponse.md)
1860
+ - [UpdateEncounterClinicalNoteRequest](UpdateEncounterClinicalNoteRequest.md)
1861
+ - [UpdateEncounterClinicalNoteResponse](UpdateEncounterClinicalNoteResponse.md)
1862
+ - [UpdateEncounterStatusRequest](UpdateEncounterStatusRequest.md)
1863
+ - [UpdateEncounterStatusResponse](UpdateEncounterStatusResponse.md)
1849
1864
  - [UpdateMedicationRequest](UpdateMedicationRequest.md)
1850
1865
  - [UpdateMedicationResponse](UpdateMedicationResponse.md)
1851
1866
  - [UpdatePatientAttributesRequest](UpdatePatientAttributesRequest.md)
@@ -20,6 +20,7 @@ Type: `object`
20
20
  | `expires_in` | `integer` | Yes | | | | No | Access token lifetime in seconds from issuance. |
21
21
  | `fhir_practitioner_id` | `string|null` | No | | | | Yes | FHIR Practitioner ID for this practitioner, used as {practitioner_id} on every other route. Null if it could not be resolved. |
22
22
  | `id_token` | `string|null` | No | | | | Yes | Cognito ID token, carrying the tenant_id claim used by other HealthCloud services. |
23
+ | `refresh_token` | `string|null` | No | | | | Yes | Cognito refresh token; pass to POST /auth/refresh to renew the access token without re-entering credentials. |
23
24
  | `telehealth_id` | `string|null` | No | | | | Yes | Telehealth service identifier for this practitioner, when the telehealth integration is enabled. Null if it could not be resolved. |
24
25
 
25
26
  ## Example
@@ -0,0 +1,18 @@
1
+ # ProviderRefreshTokenRequest
2
+
3
+ Model ID: `provider.RefreshTokenRequest`
4
+
5
+ Request body for POST /auth/refresh.
6
+
7
+ Type: `object`
8
+
9
+ ## Fields
10
+
11
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
12
+ |---|---|---:|---|---|---|---:|---|
13
+ | `refresh_token` | `string` | Yes | | | | No | Refresh token previously returned by provider.login. |
14
+ | `tenant_id` | `string` | Yes | | | | No | Tenant whose practitioner Cognito pool issued the refresh token. |
15
+
16
+ ## Example
17
+
18
+ None declared in canonical OpenAPI.
@@ -0,0 +1,21 @@
1
+ # ProviderRefreshTokenResponse
2
+
3
+ Model ID: `provider.RefreshTokenResponse`
4
+
5
+ Response for POST /auth/refresh.
6
+
7
+ Type: `object`
8
+
9
+ ## Fields
10
+
11
+ | Field | Type | Required | Format | Allowed values | Default | Nullable | Description |
12
+ |---|---|---:|---|---|---|---:|---|
13
+ | `access_token` | `string` | Yes | | | | No | New Cognito access token. |
14
+ | `expires_in` | `integer` | Yes | | | | No | Access token lifetime in seconds. |
15
+ | `id_token` | `string|null` | No | | | | Yes | New Cognito ID token, when issued. |
16
+ | `refresh_token` | `string|null` | No | | | | Yes | Rotated refresh token, when Cognito returns one. |
17
+ | `token_type` | `string` | No | | | `"Bearer"` | No | OAuth token type returned by Cognito. |
18
+
19
+ ## Example
20
+
21
+ None declared in canonical OpenAPI.