---
title: "List Employment Record"
method: GET
path: "/v2/company/{company_id}/employment_records"
tags: ["Employment Record"]
---

# List Employment Record

`GET /v2/company/{company_id}/employment_records`

## Request

- Base URL: `https://api.7shifts.com`
- URL: `https://api.7shifts.com/v2/company/{company_id}/employment_records`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.7shifts.com/oauth2/authorize`
    - Client credentials
    - Password
    - Token URL: `https://app.7shifts.com/oauth2/token`
  - API key in cookie `7session`

Returns list of employment records for user

## Path parameters

- `company_id` integer, required

## Query parameters

- `user_id` integer, nullable
- `user_ids` integer[], nullable
- `business_entity_uuid` string, nullable

## Headers

- `x-api-version` string: An API version
- `x-company-guid` string, uuid

## Response `200`

OK

- EmploymentRecordList
  - `object` 'employment_record', required
  - `data` EmploymentRecord[], required
    - `uuid` string, required: The uuid
    - `company_id` integer, required: The company_id
    - `user_id` integer, required: The user_id
    - `hire_date` string, nullable, required: The hire_date
    - `termination_date` string, nullable, required: The termination_date
    - `classification` string, nullable, required: The classification
    - `locked` boolean, required: The locked
    - `business_entity_uuid` string, nullable, required: The business_entity_uuid

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `409`: Conflict
- `422`: Unprocessable Entity
- `500`: Unexpected error

---

[API](https://skmtc.dev/7shifts/apis/7shifts-api.md) - [All operations](https://skmtc.dev/7shifts/apis/7shifts-api/llms.txt) - [OpenAPI document](https://skmtc.dev/7shifts/apis/7shifts-api/revisions/40e0ef40dfcd?raw)