---
title: "Retrieve list of employee profile"
method: GET
path: "/management/v2/employees-profile"
tags: ["Employee Profile"]
---

# Retrieve list of employee profile

`GET /management/v2/employees-profile`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/management/v2/employees-profile`
- Auth: API key in header `OAuth`

Supports searching by name, company, active status, role, and other fields using the filters parameter.

## Query parameters

- `filters` string[]
- `op` string
- `cursor` string
- `limit` integer
- `orderBy` string

## Response `200`

A successful response.

- EmployeeProfileListResponse
  - `success` boolean
  - `data` V2modelEmployeeProfile[]
    - `id` string, int64
    - `companyId` string, int64
    - `firstName` string
    - `lastName` string
    - `displayName` string
    - `contactId` string, int64
    - `dateOfBirth` string
    - `gender` 'DEFAULT_GENDER' | 'PREFER_NOT_TO_SAY' | 'MALE' | 'FEMALE' | 'NON_BINARY'
    - `userId` string, int64
    - `active` boolean
    - `startDate` string
    - `terminationDate` string
    - `role` string, int64
    - `allowAppraisal` boolean
    - `historyId` string, int64
    - `creator` string, int64
    - `createdAt` string, date-time
    - `modifiedAt` string, date-time
    - `photoUrl` string
  - `nextCursor` string: Cursor to fetch the next page of results. Base64 encoded value. Present only if more results are available. Empty string if this is the last page.

---

[API](https://skmtc.dev/deputy/apis/deputy-v2-api.md) - [All operations](https://skmtc.dev/deputy/apis/deputy-v2-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deputy/apis/deputy-v2-api/revisions/78f0278f4608?raw)