---
title: "Get engagements"
method: GET
path: "/v1/engagement"
tags: ["Engagement"]
---

# Get engagements

`GET /v1/engagement`

## Request

- Base URL: `https://app.aptrinsic.com`
- URL: `https://app.aptrinsic.com/v1/engagement`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/docs/v1/engagement/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves engagements. Supports paging.
Examples: 

| URI   | Results  |
| ----- | -------- |
| GET /v1/engagement?pageSize=100 | Get first 100 engagements. |
| GET /v1/engagement?pageSize=100&pageNumber=1 | Get next 100 engagements. |
| GET /v1/engagement?contentTypes=IN_APP_DIALOG,IN_APP_GUIDE | Get dialog and guide engagements. |

## Query parameters

- `contentTypes` string[]
- `createdById` string
- `pageNumber` integer
- `pageSize` integer

## Response `200`

Success

- EngagementsPage
  - `engagements` Engagement[]: Array of engagements
    - `defaultLanguage` string
    - `id` string, required
    - `languages` LocalizationStatus[]
      - `languageCode` string
      - `translated` boolean
    - `translationState` string
    - `name` string, required
    - `description` string
    - `type` 'EMAIL' | 'IN_APP_DIALOG' | 'IN_APP_CAROUSEL' | 'IN_APP_GUIDE' | 'IN_APP_NOTIFICATION' | 'OUT_BOUND_EMAIL' | 'IN_APP_NPS_SURVEY' | 'IN_APP_CES_SURVEY' | 'IN_APP_RATING_SURVEY' | 'IN_APP_BOOLEAN_SURVEY' | 'IN_APP_MULTIPLE_QUESTION_SURVEY', required
    - `state` 'IN_PROGRESS' | 'STARTED' | 'PAUSED' | 'FAILED' | 'EDITING' | 'COMPLETED', required
    - `propertyKeys` string[], required: Aptrinsic Tag Key, at least one is required
    - `envs` string[], required: A list of environments
  - `pageNumber` integer: Page number
  - `isLastPage` boolean: True if no more records available on next page

## Other responses

- `400`: Bad request
- `401`: Unauthorized or bad API Key
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api.md) - [All operations](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gainsight/apis/gainsight-px-rest-api/revisions/e7b197b373d8?raw)