---
title: "Find folders"
method: GET
path: "/folders"
tags: ["Folder API:Folders"]
---

# Find folders

`GET /folders`

## Query parameters

- `FolderId` integer[]
- `JobId` integer[]
- `CandidateId` integer[]
- `ApplicationId` integer[]
- `PlacementId` integer[]
- `CompanyId` integer[]
- `ContactId` integer[]
- `UserId` integer[]
- `OwnerUserId` integer[]
- `SharedWithUserId` integer[]
- `OwnerStatus` 'Active' | 'Inactive', string
- `CreatedAt` string[]
- `UpdatedAt` string[]
- `Fields` string[]
- `Embed` string[]
- `EmbedMode` string
- `Offset` integer
- `Limit` integer

## Response `200`

List of folders matching the specified criteria

- FolderListRepresentation
  - `items` FolderNameModel[], nullable
    - `folderId` integer, required
    - `name` string, nullable
    - `owner` UserNameModel
      - `userId` integer, required
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `position` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `mobile` string, nullable
      - `inactive` boolean
      - `deleted` boolean
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
  - `totalCount` integer, required
  - `links` PageLinks
    - `first` string, uri, nullable
    - `prev` string, uri, nullable
    - `next` string, uri, nullable
    - `last` string, uri, nullable

---

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