---
title: "Read the owning account's locker and metering state"
method: GET
path: "/api/lockers/{locker_id}"
---

# Read the owning account's locker and metering state

`GET /api/lockers/{locker_id}`

## Request

- Base URL: `https://genie.locker`
- URL: `https://genie.locker/api/lockers/{locker_id}`
- Auth: HTTP bearer

## Path parameters

- `locker_id` string, required

## Response `200`

locker, expiry, credits spent, renewal and cap state

## Other responses

- `401`: unknown account key
- `404`: locker not found for this account

---

[API](https://skmtc.dev/genie/apis/genie-locker.md) · [All operations](https://skmtc.dev/genie/apis/genie-locker/llms.txt) · [OpenAPI document](https://skmtc.dev/genie/apis/genie-locker/revisions/9ace85ce8948?raw)