# Retrieve content item hierarchy children

Fetches a page of direct child items for a hierarchy node. Designed for user interfaces that display hierarchical content, such as tree pickers (controls that let users browse and select items by expanding and collapsing nodes), this endpoint lets you incrementally load large or deep hierarchies as users navigate them rather than retrieving the entire hierarchy in a single request.

Endpoint: GET /api/v1/content-items/{id}/hierarchy/children
Version: v1
Security: Bearer

## Security:

  - `Bearer` (unknown)
    http Bearer

## Path parameters:

  - `id` (string, required)
    The identifier of the hierarchy node (parent) whose children should be retrieved.

## Query parameters:

  - `environmentId` (string)
    The environment identifier. Defaults to "main". Currently only "main" is supported.

  - `language` (string)
    The language code of the parent item for retrieving child item metadata. Defaults to "en".

  - `limit` (integer)
    The maximum number of children to return in a single page. Defaults to 50 when omitted.

## Header parameters:

  - `x-sc-continuation` (string)
    An optional opaque continuation token, returned from a previous call, used to fetch the next page of children.

## Response 200:

  - `200` (unknown)
    Successful operation

## Response 200 fields (application/json):

  - `items` (array)
    The children found on this page.

  - `items.hasPresentation` (boolean)
    Whether the content item has presentation details. An item with presentation is an item with a layout assigned.
    Example: true

  - `items.hasChildren` (boolean)
    Whether the content item has any child items. Used by clients to render expand/collapse controls
without issuing an additional request.
    Example: true

  - `items.contentModelName` (string)
    The content type (data template) name.
    Example: Product

  - `items.id` (string)
    The content item identifier.
    Example: 3875AC96-8ECF-44AE-8E25-851068B373CE

  - `items.name` (string)
    The content item name.
    Example: My content item

  - `items.displayName` (string)
    The content item display name.
    Example: My content item

  - `items.language` (string)
    The content item language.
    Example: en

  - `items.version` (integer)
    The content item version.
    Example: 1

  - `items.templateId` (string)
    The template identifier.
    Example: 97265ed7-85cf-4876-9c09-b6590fc6cf3a

  - `items.path` (string)
    The content item path.
    Example: /sitecore/content/

  - `items.permissions` (object)
    The access rights of the current user to the site.

  - `items.permissions.canAdmin` (boolean)
    Whether the current user has admin rights
    Example: true

  - `items.permissions.canWrite` (boolean)
    Whether the current user has permissions to edit values
    Example: true

  - `items.permissions.canCreate` (boolean)
    Whether the current user has permissions to create entities
    Example: true

  - `items.permissions.canDelete` (boolean)
    Whether the current user has permissions to delete entities
    Example: true

  - `items.permissions.canRename` (boolean)
    Whether the current user has permissions to rename  entities
    Example: true

  - `items.permissions.canRead` (boolean)
    Whether the current user has permissions to see  entities
    Example: true

  - `items.permissions.canPublish` (boolean)
    Whether the current user has permissions to publish sites in this environment
    Example: true

  - `items.permissions.canDuplicate` (boolean)
    Whether the current user has permissions to duplicate entities
    Example: true

  - `items.permissions.canWriteLanguage` (boolean)
    Whether the current user has permissions to write item language entities
    Example: true

  - `items.system` (object)

  - `items.system.created` (string)
    The creation time.
    Example: 2024-01-15T10:30:00Z

  - `items.system.createdBy` (string)
    The creator.
    Example: sitecore admin

  - `items.system.updated` (string)
    The last updating time.
    Example: 2024-01-15T10:30:00Z

  - `items.system.updatedBy` (string)
    The last updater.
    Example: sitecore admin

  - `continuationToken` (string)
    An opaque continuation token used to fetch the next page of children. Null when there
are no additional pages remaining.
    Example: MXx8fDUw

## Response 400:

  - `400` (unknown)
    Invalid input format

## Response 400 fields (application/json):

  - `type` (string)
    The type of the error response entity.

  - `title` (string)
    The title of the error response entity.

  - `status` (integer)
    The response status code.

  - `detail` (string)
    A detailed explanation, specific to this occurrence of the problem.

  - `instance` (string)
    If available, a URI reference that identifies the specific occurrence of the problem.

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 401 fields (application/json):

  - `type` (string)
    The type of the error response entity.

  - `title` (string)
    The title of the error response entity.

  - `status` (integer)
    The response status code.

  - `detail` (string)
    A detailed explanation, specific to this occurrence of the problem.

  - `instance` (string)
    If available, a URI reference that identifies the specific occurrence of the problem.

## Response 404:

  - `404` (unknown)
    Invalid content item ID

## Response 404 fields (application/json):

  - `type` (string)
    The type of the error response entity.

  - `title` (string)
    The title of the error response entity.

  - `status` (integer)
    The response status code.

  - `detail` (string)
    A detailed explanation, specific to this occurrence of the problem.

  - `instance` (string)
    If available, a URI reference that identifies the specific occurrence of the problem.