Skip to main content

What's new in the API 2025

Updated today

Here are the improvements and fixes to the TELUS Collaborative Health Record (CHR) Enterprise API.

💡 Tip: For a list of all API improvements and fixes in 2024, refer to What was new in API in 2024.


Version 25.24

Improvements

  • language header

    • A new optional language header has been added that accepts "en" or "fr" to control the language of localized fields in the response. This feature requires the CHR domain to be configured for English/French support and defaults to English.

  • service(s) query

    • The service(s) query now supports returning the following additional fields; longDescription, shortDescription, localizedName, localizedLongDescription, LocalizedShortDescription. A name filter has been added that filters based on service name and supports searching based on the new language header.

  • presentingIssue(s) query

    • The presentingIssue(s) query now supports returning the following additional fields; localizedName, localizedInternalName, localizedPrepNote.

Version 25.23

Improvements

  • patient query

    • The patient type now includes the pronouns field that represents the patient’s pronouns.

  • createPatient mutation

    • The createPatient mutation now supports setting the patient’s pronouns.

  • updatePatient mutation

    • The updatePatient mutation now supports updating the patient’s pronouns.

  • task query

    • The task query returns a list of an account’s or patient’s tasks. A singular query is also available.

      • 📌Note: Requires the new task feature to be enabled for your account to get results.

Version 25.22

Improvements

  • upsertReferralDataItem mutation

    • The upsertReferralDataItem mutation supports updating or inserting a value for a referral data item on a referral record.

Version 25.21

Improvements

  • referralDataSettings query

    • The referralDataSettings returns the available referral data items as configured on the account.

Version 25.20

Improvements

  • taskTemplate query

    • The taskTemplate query returns a list of an account’s task templates. A singular query is also available.

      • 📌Note: Requires the new task feature to be enabled for your account to get results.

  • referralRecord query

    • The referralRecord type now includes a sub-query for the referral data items.

Version 25.19

Improvements

  • availabilities query

    • The availabilities query now returns availabilities based startAt and untilAt within the time range provided in the from and to arguments.

Version 25.18

Improvements

  • taskCategories query

    • The taskCategories query returns a list of an account’s task categories. A singular query is also available.

      • 📌Note: Requires the new task feature to be enabled for your account to get results.

  • updateFacility mutation

    • The updateFacility mutation supports updating a facility record in the address book.

  • createStandardWorkHour mutation

    • The createStandardWorkHour mutation supports creating a standard work hour for a provider’s schedule.

  • createFlexibleWorkHour mutation

    • The createFlexibleWorkHour mutation supports creating a flexible work hour for a provider’s schedule.

Version 25.17

Improvements

  • facility query

    • The facility type now includes the following additional fields:

      • categoryRawValue

      • readOnly

    • The category filter on the facility query has been updated to support search by enum.

    • The facility query filters have been extended with the following additional filters:

      • excludeReadOnly

      • categoryRawValue

  • updateContact mutation

    • The updateContact mutation supports updating a contact record in the address book.

  • createProviderOfftime mutation

    • The createProviderOfftime mutation supports creating offtime within a provider’s schedule.

  • availabilities query

    • The availabilities query has been updated to ensure timezone accuracy by limiting queries to a single timezone. Queries made that include locations (explicitly or by default) with multiple timezones will return an error.

Version 25.16

Improvements

  • createFacility mutation

    • The createFacility mutation supports creating a facility record in the address book.

  • providerUser query

    • The providerUser type now includes a schedule query with the following sub-queries:

      • standardWorkHours

      • fexibleWorkHours

      • offtimes

  • referralRecord query

    • The referralRecord type now includes a sub-query for the referral comments.

Version 25.15

Improvements

  • createContact mutation

    • The createContact mutation supports creating a contact record in the address book.

  • contact query

    • The contact type now includes the following additional fields:

      • medicalSpecialty

      • medicalSpecialtyRawValue

      • occupationRawValue

      • titleRawValue

      • jurisdiction

      • jurisdictionRawValue

      • readOnly

    • The contact query filters have been extended with the following additional filters:

      • excludeReadOnly

      • occupationRawValue

  • addReferralRecordComment mutation

    • The addReferralRecordComment mutation supports adding a comment to a referral record.

  • updateInternalReferralRecord, updateIncomingReferralRecord and updateOutgoingRegerralRecord mutations

    • The various updateReferralRecord mutations now support adding/removing attachments with the CombinedReferralRecordAttachmentInput.

  • provider query

    • The providerUser type now includes the provider user’s title.

Version 25.14

Improvements

  • createInternalReferralRecord, createIncomingReferralRecord and createOutgoingReferralRecord mutations

    • The various createReferralRecord mutations now support attachments during referral creation with the AddReferralRecordAttachmentInput.

  • contact query

    • The contact type now includes the contact’s license number.

Version 25.13

Improvements

  • cases query

    • The cases type now exposes the attachments and observations related to a case as a subquery.

    • The cases query now supports filtering based on the assignedProviderUser field.

  • updateInternalReferralRecord, updateIncomingReferralRecord and updateOutgoingRegerralRecord mutations

    • The various updateReferralRecord mutations now support setting a referral record to a status that requires the referral record to be archived.

Version 25.12

There are no updates to the Enterprise API in this version.

Version 25.11

Improvements

  • availabilities query

    • The availabilities query has been updated to support 7 days based on provided filters, instead of only supporting Sun-Sat behaviour.

  • referralRecord query

    • The referralRecord type now exposes the attachments related to a referral record as a subquery.

  • patientDataItems query

    • An issue has been resolved where extra/duplicated patientDataItems were included in the patientDataItems query.

Version 25.10

Improvements

  • createAttachment mutation

    • The createAttachmentInput now supports a notifyOwner boolean field.

  • cases query

    • The cases query returns a list of a patient’s cases. A singular query is also available.

Version 25.09

Improvements

  • Patient Merge ENS notifications

    • patient.merged events are now available

  • Encounter ENS notifications

    • The following encounter events are now available:

      • encounter.created

      • encounter.deleted

      • encounter.signed

      • encounter.unlocked

  • Referral ENS notifications

    • Created and updated referral events are now available for:

      • incoming referrals

      • internal referrals

      • outgoing referrals

Version 25.08

There are no updates to the Enterprise API in this version.

Version 25.07

Improvements

  • updateInternalReferralRecord mutation

    • The updateInternalReferralRecord mutation supports the update of an internal referral record.

  • updateOutgoingReferralRecord mutation

    • The updateOutgoingReferralRecord mutation supports the update of an outgoing referral record.

  • updateIncomingReferralRecord mutation

    • The updateIncomingReferralRecord mutation supports the update of an incoming referral record.

  • assignReferralRecordToWaitingList mutation

    • The assignReferralRecordToWaitingList mutation supports assigning a referral to a waitlist.

Version 25.06

Improvements

  • caseTemplates query

    • The caseTemplates query returns a list of an account’s configured templates for cases. A singular query is also available.

  • caseStatuses query

    • The caseStatuses query returns a list of an account’s configured statuses for cases. A singular query is also available.

Version 25.05

Improvements

  • createInternalReferralRecord mutation

    • The createInternalReferralRecord mutation supports the creation of an internal referral record.

  • createOutgoingReferralRecord mutation

    • The createOutgoingReferralRecord mutation supports the creation of an outgoing referral record.

  • createIncomingReferralRecord mutation

    • The createIncomingReferralRecord mutation supports the creation of an incoming referral record.

  • answer type

    • The answer type has been extended with additional fields.

Version 25.04

There are no updates to the Enterprise API in this version.

Version 25.03

Improvements

  • referralRecords query

    • The referralRecord query returns a list of an account’s or patient’s referral records. A singular query is also available.

  • referralStatues query

    • The referralStatuses query returns a list of an account’s configured statuses for referrals. A singular query is also available.s

  • referralPriorities query

    • The referralPriorities query returns a list of an account’s configured priorities for referrals. A singular query is also available.

  • referralWaitingLists query

    • The referralWaitingLists query returns a list of an account’s configured waiting lists for referrals. A singular query is also available.

Version 25.02

There are no updates to the Enterprise API in this version.

Version 25.01

Improvement

  • patientDataCategories query

    • The patientDataCategories query returns a list of an account’s patient data categories. A singular query is also available.

Did this answer your question?