---
title: "GET /v2/api/{network}/locks/{lockAddress}/keys-by-page"
method: GET
path: "/v2/api/{network}/locks/{lockAddress}/keys-by-page"
---

# GET /v2/api/{network}/locks/{lockAddress}/keys-by-page

`GET /v2/api/{network}/locks/{lockAddress}/keys-by-page`

List of lock keys by network with additional metadata if the caller is the lockManager

## Path parameters

- `network` integer, required
- `lockAddress` string, required

## Query parameters

- `query` string, required
- `filterKey` string, required
- `expiration` string
- `approval` string
- `page` integer
- `max` integer

## Response `200`

List of keys matching the query

- object
  - `meta` object
    - `total` integer
    - `page` integer
    - `byPage` integer
  - `keys` KeyMetadata[]
    - `token` string
    - `lockName` string
    - `lockAddress` string
    - `expiration` integer
    - `keyHolderAddress` string

## Other responses

- `404` — The item you are making request for does not exist.
- `500` — Unable to fullfil request due to internal server error.

---

[API](https://skmtc.net/unlock-protocol/apis/unlock-locksmith.md) · [All operations](https://skmtc.net/unlock-protocol/apis/unlock-locksmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unlock-protocol/unlock-locksmith/versions/e003b998de45/schema)