# Retrieve list of objects under specified folder

Retrieve a list of objects under a specified folder, including child folders, segments, batch segments, predictive scoring models, funnels, Profile API tokens and Journeys.

Endpoint: GET /entities/by-folder/{folderId}
Version: 1.0.0
Security: TdApikeyAuth

## Path parameters:

  - `folderId` (integer, required)
    Segment Folder ID

## Query parameters:

  - `depth` (integer, required)
    Depth of retrieved folders

  - `with_rule` (boolean)
    Set false to ignore the segment rule

## Response 200 fields (application/json):

  - `data` (array, required)

  - `included` (array, required)

  - `included.id` (string, required)

  - `included.type` (string, required)
    Enum: "user"

  - `included.attributes` (object, required)

  - `included.attributes.tdUserId` (string, required)

  - `included.attributes.name` (string, required)