Skip to content

Get an encounter's care team

The current care team. Zone-derived nurses are computed at read time (`id: null`, `source: zone`). Staff hidden from patients are listed with `hiddenFromPatients: true`.

GET
/v1/encounters/{encounterId}/care-team

The current care team. Zone-derived nurses are computed at read time (id: null, source: zone). Staff hidden from patients are listed with hiddenFromPatients: true.

Authorization

AuthorizationBearer <token>

OAuth 2.0 client credentials. private_key_jwt (SMART Backend Services asymmetric) is recommended; client secrets need an IP allowlist or mTLS outside the sandbox.

In: header

Scope: careteam:read

Path Parameters

encounterId*string

An opaque enc_ id.

Match^enc_[0-9A-Za-z]{16,64}$

Header Parameters

Api-Version?enum

Overrides the app's pinned dated version for this request.

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/encounters/enc_k57a1x2m9q4t8v3w5x1y6z7a8b9c0d1e/care-team"
{  "encounterId": "enc_k57a1x2m9q4t8v3w5x1y6z7a8b9c0d1e",  "members": [    {      "hiddenFromPatients": true,      "id": "ctm_k57a1x2m9q4t8v3w5x1y6z7a8b9c0d1e",      "isPrimary": true,      "practitioner": {        "display": "string",        "identifiers": [          {            "externalId": "string",            "idSystem": "string"          }        ]      },      "role": "string",      "since": "2026-09-14T15:00:11.402Z",      "source": "ehr"    }  ],  "object": "care_team"}

Was this page helpful?