---
title: "Get Service Bundle"
method: GET
path: "/v1/employers/{employerId}/service-bundles/{id}"
tags: ["Employers", "Service Bundles"]
---

# Get Service Bundle

`GET /v1/employers/{employerId}/service-bundles/{id}`

## Request

- Base URL: `https://api.bluehive.com`
- URL: `https://api.bluehive.com/v1/employers/{employerId}/service-bundles/{id}`
- Auth: API key in header `Authorization`

## Path parameters

- `employerId` string, required
- `id` string, required

## Response `200`

Default Response

- object
  - `_id` string, required
  - `employerId` string, required
  - `bundleName` string, required
  - `serviceIds` string[], required
  - `roles` string[], nullable
  - `limit` number
  - `occurrence` string
  - `recurring` boolean
  - `startDate` string
  - `integrationData` object
    - `enterprise-health` object
      - `addOnServices` boolean
  - `createdAt` string
  - `createdBy` string
  - `updatedAt` string
  - `updatedBy` string
  - `externallyManaged` boolean: Indicates if this bundle originated from a third-party integration. Externally managed bundles cannot be edited or deleted in BlueHive.
  - `integration` string, nullable: Name of the third-party integration that manages this bundle (e.g., "Enterprise Health"). Null if bundle was created in BlueHive.

## Other responses

- `401`: Default Response
- `404`: Default Response
- `500`: Default Response

## Changes

- **2026-02-18** `efcb45ec0e67`: 1 info
  - added the optional property `integrationData` to the response with the `200` status
- **2026-02-05** `63bca4bb1614`: 2 info
  - added the optional property `externallyManaged` to the response with the `200` status
  - added the optional property `integration` to the response with the `200` status
- **2025-10-13** `c5da7f3b01ee`: 4 info
  - added the optional property `limit` to the response with the `200` status
  - added the optional property `occurrence` to the response with the `200` status
  - added the optional property `recurring` to the response with the `200` status
  - added the optional property `startDate` to the response with the `200` status
- **2025-10-05** `28d439490b5e`: 1 breaking, 1 info
  - the response property `roles` became nullable for the status `200`
  - response property `roles` list-of-types was narrowed by removing types `null` from media type `application/json` of response `200`
- **2025-10-05** `3c4bce10c1fe`: 1 breaking
  - response property `roles` list-of-types was widened by adding types `null` to media type `application/json` of response `200`

[Operation history](https://skmtc.dev/bluehive-health/apis/bluehive-api/changes/v1/employers/:employerId/service-bundles/:id/get.md)

---

[API](https://skmtc.dev/bluehive-health/apis/bluehive-api.md) - [All operations](https://skmtc.dev/bluehive-health/apis/bluehive-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bluehive-health/apis/bluehive-api/revisions/a8bcbdf02e33?raw)