---
title: "Retrieve employee profiles by IDs and custom filters"
method: POST
path: "/management/v2/employee-profile:by-ids-and-custom-filters"
tags: ["Employee Profile"]
---

# Retrieve employee profiles by IDs and custom filters

`POST /management/v2/employee-profile:by-ids-and-custom-filters`

## Request

- Base URL: `https://your-subdomain.deputy.deputy.com/api`
- URL: `https://your-subdomain.deputy.deputy.com/api/management/v2/employee-profile:by-ids-and-custom-filters`
- Auth: API key in header `OAuth`

Retrieve employee profiles by IDs and custom filters.

## Request body

- EmployeeProfileRetrieveEmployeeProfileByIdsAndCustomFiltersRequest
  - `filters` string[]
  - `op` string
  - `cursor` string
  - `limit` integer
  - `employeeIds` string[]
  - `mainLocations` string[]
  - `employmentTypes` string[]

## Response `200`

A successful response.

- EmployeeProfileRetrieveEmployeeProfileByIdsAndCustomFiltersResponse
  - `success` boolean
  - `data` ModelEmployeeProfileBasic[]
    - `id` string, int64
    - `companyId` string, int64
    - `firstName` string
    - `lastName` string
    - `displayName` string
    - `userId` string, int64
    - `photoUrl` string
    - `mainLocation` string
    - `employmentType` string
    - `email` string
  - `nextCursor` string

---

[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)