---
title: "Get member context for an engagement (external)"
method: GET
path: "/api/v1/external/engagements/{engagement_id}/context"
tags: ["Engagements"]
---

# Get member context for an engagement (external)

`GET /api/v1/external/engagements/{engagement_id}/context`

## Request

- Base URL: `https://api.cloverhealth.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.cloverhealth.com/api/v1/external/engagements/{engagement_id}/context`
- Auth: HTTP bearer

Requires OAuth scope: engagement:context

All callers with the base scope receive `member_verified`, `intent`,
`category`, and `mx_agent` alongside the other basic identifying fields.
A JWT additionally granted `engagement:context:full` also receives
`master_record_id`, `support_team`, and the Engagement's full `metadata`
blob -- same as the internal endpoint. Callers without that scope never
see those keys.

Note: engagement_id is an opaque UUID, safe as a path parameter. Member
PHI (name, subscriber ID, language) is returned in the body only.

## Path parameters

- `engagement_id` string, uuid, required

## Response `200`

OK

- EngagementContextResponse: Member context associated with an Engagement. All member fields are nullable — an Engagement with no linked or resolvable member still returns 200 with those fields set to null.
  - `engagement_id` string, uuid, required
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `subscriber_id` string, nullable
  - `preferred_language` string, nullable
  - `member_verified` boolean, nullable
  - `intent` string, nullable
  - `master_record_id` string, nullable
  - `support_team` string, nullable
  - `category` string, nullable
  - `mx_agent` boolean, nullable
  - `lh_balance` boolean, nullable
  - `member_preferred_buddy` string, nullable
  - `member_preferred_buddy_worker_sid` string, nullable
  - `member_preferred_buddy_matched` string, nullable

## Other responses

- `404`: Not Found

## Changes

- **2026-10-02** `3f34144ebdf3`: 1 info
  - added the optional property `lh_balance` to the response with the `200` status
- **2026-09-30** `bf6518b9b2f5`: 1 info
  - added the optional property `member_preferred_buddy_matched` to the response with the `200` status
- **2026-09-27** `ef3e500c7d32`: 2 info
  - added the optional property `member_preferred_buddy` to the response with the `200` status
  - added the optional property `member_preferred_buddy_worker_sid` to the response with the `200` status
- **2026-09-18** `5202b34abf64`: 1 info
  - added the optional property `mx_agent` to the response with the `200` status
- **2026-09-11** `71a063e2c91b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cloverhealth/apis/clover-api/changes/api/v1/external/engagements/:engagement_id/context/get.md)

---

[API](https://skmtc.dev/cloverhealth/apis/clover-api.md) - [All operations](https://skmtc.dev/cloverhealth/apis/clover-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloverhealth/apis/clover-api/revisions/824d541751f2?raw)