---
title: "Addresses you have unlocked"
method: GET
path: "/v1/account/reveals"
tags: ["Unlocks"]
---

# Addresses you have unlocked

`GET /v1/account/reveals`

## Request

- Base URL: `https://api.pmwallets.com`
- URL: `https://api.pmwallets.com/v1/account/reveals`
- Auth: API key in header `x-api-key`

Your unlock receipts, newest payment first (up to 500). A lapsed free unlock shows its handle, `entitled: false` and the price to take it back.

## Response `200`

OK

- Unlock[]
  - `entityId` string: Address while entitled; handle when a free unlock has lapsed.
  - `label` string
  - `chain` integer
  - `priceCents` integer: What was paid (0 = free unlock).
  - `entitled` boolean: false = a free unlock whose wallet has since moved into a paid band.
  - `revealCents` integer: Only when not entitled: the price to take it back.
  - `createdAt` string, date-time
  - `paidAt` string, date-time, nullable

## Other responses

- `401`: No valid API key (missing, malformed, unknown or revoked).

---

[API](https://skmtc.dev/pmwallets/apis/pmwallets-api.md) · [All operations](https://skmtc.dev/pmwallets/apis/pmwallets-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pmwallets/apis/pmwallets-api/revisions/d5023fb40430?raw)