---
title: "Get certification key history"
method: GET
path: "/v1/dpp/certification-key/history"
tags: ["DPP"]
---

# Get certification key history

`GET /v1/dpp/certification-key/history`

## Request

- Base URL: `https://api.prod.keyban.io`
- URL: `https://api.prod.keyban.io/v1/dpp/certification-key/history`
- Auth: `X-Api-Key` (a scheme the document does not define)

Retrieve all certification keys for the organization, including rotated and revoked keys.

## Response `200`

- CertificationKeyHistoryResponseDto
  - `keys` object[], required: Chronological history of all certification keys for the organization, ordered by activation date descending (most recent first).
    - `id` string, uuid, required: Key ID
    - `publicKey` string, required: Public key (hex)
    - `status` 'active' | 'pending' | 'rotated' | 'revoked', required: Key status
    - `name` string, nullable: Optional key name
    - `activatedAt` string, date-time, required: When the key was activated
    - `deactivatedAt` string, date-time, nullable: When the key was deactivated
    - `createdAt` string, date-time, required: Creation timestamp
    - `registeredNetworks` string[], required: Networks where the key was registered

---

[API](https://skmtc.dev/keyban/apis/keyban-rest-apis.md) · [All operations](https://skmtc.dev/keyban/apis/keyban-rest-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/keyban/apis/keyban-rest-apis/revisions/0bb79a1da961?raw)