---
title: "Get vendor engagements"
method: GET
path: "/api/v2/bridge/engagements"
tags: ["Black Kite Bridge"]
---

# Get vendor engagements

`GET /api/v2/bridge/engagements`

Retrieves a paginated list of vendor engagements over Black Kite Bridge.

## Query parameters

- `page_number` integer
- `page_size` 10 | 20 | 30 | 50 | 100 | 250
- `company_ids` string
- `ecosystem_ids` string
- `sharing_by_users` string
- `shared_start_date` string, date-time
- `shared_end_date` string, date-time
- `status` 'NoResponse' | 'Registered' | 'Active'

## Response `200`

Success

- BlackKiteBridgeEngagement[]
  - `CompanyId` integer — The ID of the company in BlackKite.
  - `CompanyName` string — The name of the company in BlackKite.
  - `Status` 'NoResponse' | 'Registered' | 'Active' — Current engagement status. NoResponse: No response from vendor, Registered: Vendor has registered but no recent login, Active: Vendor has recent login activity.
  - `InitialShareDate` string, date-time, nullable — Timestamp of the initial share activity.
  - `TotalReportsShared` integer — Total number of reports shared with this vendor.
  - `TotalTicketsAssigned` integer — Total number of tickets assigned to this vendor.
  - `ClosedTicketsPercentage` integer — Percentage of closed tickets out of total assigned tickets.
  - `TotalAssessmentsShared` integer — Total number of assessments shared with this vendor.

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `default` — Failure

---

[API](https://skmtc.net/blackkitetech/apis/black-kite-api.md) · [All operations](https://skmtc.net/blackkitetech/apis/black-kite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blackkitetech/black-kite-api/revisions/7dadaba760fb/schema)