---
title: "List the caller principal's retained identity-link history"
method: GET
path: "/identity-links/v1"
tags: ["Identity Links"]
---

# List the caller principal's retained identity-link history

`GET /identity-links/v1`

## Request

- Base URL: `https://api.run402.com`
- URL: `https://api.run402.com/identity-links/v1`
- Auth: API key in header `SIGN-IN-WITH-X`

Returns active, revoked, and principal-inactive effective lifecycle state. It exposes no authenticator inventory, credential, wallet signature, or Nostr event; use the isolated public proof resource for independent verification.

## Query parameters

- `limit` integer
- `cursor` string

## Headers

- `SIGN-IN-WITH-X` string, required

## Response `200`

Identity-link history page

- object
  - `identity_links` LinkedIdentityRepresentation[], required
    - `identity_link_id` string, required
    - `proof_protocol` 'run402.identity-link.nostr.v1' | 'run402.identity-link.nostr.human.v1', required
    - `kind` string, required: Current v1 value is nostr_nip01; clients must preserve unknown future kinds.
    - `public_subject` string, required
    - `display_subject` string, required
    - `verified_at` string, date-time, required
    - `status` 'active' | 'revoked', required
    - `effective_status` 'active' | 'revoked' | 'principal_inactive', required
    - `revoked_at` string, date-time, nullable, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid cursor or limit

---

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