---
title: "List employee onboarding experiences"
method: GET
path: "/api/v1/employees/{employeeId}/onboarding-experiences"
tags: ["Onboarding", "Public API"]
---

# List employee onboarding experiences

`GET /api/v1/employees/{employeeId}/onboarding-experiences`

Returns onboarding experiences for the employee when the onboarding experience phase-1 and workflow framework company toggles are enabled, and at least one OnboardingExperienceWorkflow execution is running for them. Each item is projected from the employee’s new hire packet instance row for the same public id contract (no embedded NHP payload).

OAuth Scopes: onboarding

## Path parameters

- `employeeId` integer, required

## Response `200`

Success

- object
  - `onboardingExperiences` OnboardingExperiencePublicApi[] — Onboarding experience summaries (empty when no running workflow for this employee).
    - `id` integer — Onboarding experience id (same as the new hire packet instance primary key).
    - `employeeId` integer — Employee this onboarding experience belongs to.
    - `newHirePacketId` integer — Primary key of the linked new hire packet instance (NHP row).
    - `nhpTemplateId` integer, nullable — Linked NHP template id, if any.
    - `nhpConfigurationId` integer, nullable — Linked NHP configuration id, if any.
    - `status` 'cancelled' | 'completed' | 'sent' | 'draft' — Derived lifecycle status for the linked new hire packet instance.

## Other responses

- `403` — Forbidden — missing OAuth permission, onboarding experience phase-1 / workflow framework feature not enabled for the company, or caller cannot access the employee.
- `500` — Internal server error

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)