---
title: "Retrieves a Engagement resource."
method: GET
path: "/engagements/{id}"
tags: ["Engagement"]
---

# Retrieves a Engagement resource.

`GET /engagements/{id}`

Retrieves a Engagement resource.

## Path parameters

- `id` string, required

## Response `200`

Engagement resource

- Engagement — Engagement represents CRM actions stored as notes, tasks, meetings and calls
  - `id` string
  - `integration` string — The key of the integration source e.g. "quickbooks", or "xero"
  - `srcId` string — Unique identifier for each engagement
  - `isActive` boolean, nullable — Whether an engagement is active or not
  - `created` string — The date and time the engagement was created
  - `modified` string, nullable — The date and time the engagement was last modified
  - `type` string, nullable — The type of engagement e.g. "MEETING" e.g. "CALL"
  - `contactIds` string[], nullable — A list of IDs for associated contacts records
  - `companyId` string, nullable — The ID of the associated company
  - `dealIds` string[], nullable — A list of IDs for associated deal records

## Other responses

- `404` — Resource not found

---

[API](https://skmtc.net/bossinsights/apis/boss-insights.md) · [All operations](https://skmtc.net/bossinsights/apis/boss-insights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bossinsights/boss-insights/versions/d08a107895ad/schema)