---
title: "List keys."
method: GET
path: "/layers/{layerId}/keys"
tags: ["by-key"]
---

# List keys.

`GET /layers/{layerId}/keys`

List virtual directory-like structure created from keys in the storage where '/' is used as a separator.

## Path parameters

- `layerId` string, required

## Query parameters

- `parent` string
- `pageToken` string
- `limit` integer
- `deep` boolean

## Response `200`

OK - Response includes a list of keys.

- KeysListResponse — Paginated response of keys and common prefixes.
  - `pageToken` string — Page token to fetch the next page.
  - `items` KeysListObjectItemResponse[], required
    - `name` string, required — Name of the object/common prefix.
    - `size` integer — Object size in bytes or omitted if the `type` field is `commonPrefix`.
    - `lastModified` string, date-time — Last modified date and time in RFC 3339 format or omitted if the `type` field is `commonPrefix`.
    - `type` 'object' | 'commonPrefix', required — Indicates whether the item is object or common prefix.

## Other responses

- `400` — User Error - Invalid input is provided
- `401` — Unauthorized - the request didn't provide correct authentication details
- `403` — Forbidden - the specific account doesn't have correct privileges to perform the operation
- `500` — Server unavailable or internal server error
- `502` — Server unavailable or internal server error
- `503` — Server unavailable or internal server error
- `504` — Server unavailable or internal server error

---

[API](https://skmtc.dev/here/apis/query-api-v1.md) · [All operations](https://skmtc.dev/here/apis/query-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/here/query-api-v1/revisions/30e5d2645407/schema)