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

# GET /v2/api/{network}/locks/{lockAddress}/keys

`GET /v2/api/{network}/locks/{lockAddress}/keys`

> **Deprecated.**

List of lock keys by network with additional metadata if the caller is the lockManager (deprecated, use keys-by-page)

## 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

- 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.

## Changes

- **2024-05-07** `e8b4083d484c` — 1 info
  - endpoint deprecated
- **2024-01-25** `351651d57bc4` — 1 info
  - added the new optional `query` request parameter `approval`
- **2023-11-03** `b77bfb068867` — 1 warning, 1 info
  - deleted the `query` request parameter `approval`
  - endpoint reactivated

[Change history](https://skmtc.dev/unlock-protocol/apis/unlock-locksmith/changes/v2/api/:network/locks/:lockAddress/keys/get.md)

---

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