---
title: "List pre-onboarding requirements for an employment"
method: GET
path: "/v1/onboarding/employments/{employment_id}/pre-onboarding-requirements"
tags: ["Pre-Onboarding Requirements"]
---

# List pre-onboarding requirements for an employment

`GET /v1/onboarding/employments/{employment_id}/pre-onboarding-requirements`

Returns the list of pre-onboarding requirements — both documents (e.g. master service
agreements, individual labour agreements) and acknowledgements — that must be fulfilled
before the given employment can be onboarded. Each requirement carries its `type`, current
`status`, and the requirement it `depends_on` (if any).


## Scopes

| Category | Read only Scope | Write only Scope (read access implicit) |
|---|---|---|
| Manage employment documents (`employment_documents`) | View documents (`document:read`) | Manage documents (`document:write`) |

## Path parameters

- `employment_id` string, required

## Response `200`

Success

- IndexPreOnboardingRequirementsResponse — List of pre-onboarding requirements for an employment.
  - `data` PreOnboardingRequirement[], required
    - `depends_on_requirement` PreOnboardingRequirement, required — recursive
    - `description` string, required — Human-readable description; rich HTML for acknowledgement requirements.
    - `freeze_employment_data` boolean, nullable, required — Whether the employment data is frozen because this requirement is finished.
    - `name` string, required — Human-readable name of the requirement.
    - `redlining_help_email` string, nullable, required — Email address to contact for help with redlining (document requirements only).
    - `slug` string, uuid, required — Identifier of the employment being terminated.
    - `status` 'blocked' | 'awaiting' | 'finished' | 'revised', nullable, required — Current status of this requirement for the given employment.
    - `supports_redlining` boolean, nullable, required — Whether the requirement supports redlining (document requirements only).
    - `type` 'document' | 'acknowledgement', required — The requirement type.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

---

[API](https://skmtc.net/remote-com/apis/remote.md) · [All operations](https://skmtc.net/remote-com/apis/remote/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/remote-com/remote/revisions/7e6a0c61ac82/schema)