---
title: "Get a customer engagement setup"
method: GET
path: "/customer-engagement-setups/{customer_engagement_setup_id}"
tags: ["Customer engagement"]
---

# Get a customer engagement setup

`GET /customer-engagement-setups/{customer_engagement_setup_id}`

Get information about a specific customer engagement setup.

Returns the full configuration of a single customer engagement setup, which defines the tracking behaviour for a specific deployment of the CareCloud JavaScript tracking script. When a visitor is identified (for example, after login), events captured by the script are linked to the corresponding customer profile.

This endpoint does not require authentication. To retrieve all available setups, use [GET /customer-engagement-setups](https://carecloud.readme.io/reference/getcustomerengagementsetups).

## Path parameters

- `customer_engagement_setup_id` string, required

## Headers

- `Accept-Language` string

## Response `200`

OK

- object
  - `data` CustomerEngagementSetup — Customer engagement setup structure.
    - `setup_id` string — The unique ID of the customer engagement setup.
    - `setup` string — Serialized JSON contains the customer engagement setup for the application
    - `state` 0 | 1 | 2 — State of the customer engagement setup. *Possible values are: 0 - deleted / 1 - active / 2 - non active*

## Other responses

- `400` — Bad input parameter. The response body's `error.error_data.invalid_params[]` array lists the parameters that caused the failure, each carrying a `reason` code. See the `BadRequestErrorBody` schema for the generic reason taxonomy. Operations with domain-specific business rules document additional reasons at the operation level.
- `403` — The client does not exist or the client tried to access an unauthorized property or resource.
- `404` — The resource was not found.
- `405` — The resource does not support the specified HTTP method.
- `429` — Too many requests - more than the resource limit.
- `500` — Server is not working as expected.
- `503` — Temporary state when the service is temporarily unavailable, overloaded or there is a maintenance window.

---

[API](https://skmtc.net/crmcarecloud/apis/rest-api-reference.md) · [All operations](https://skmtc.net/crmcarecloud/apis/rest-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/crmcarecloud/rest-api-reference/revisions/329c06dbf8d9/schema)