---
title: "Get DPP metrics"
method: GET
path: "/v1/admin/metrics/dpp"
tags: ["Metrics"]
---

# Get DPP metrics

`GET /v1/admin/metrics/dpp`

## Request

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

Retrieve Digital Product Passport metrics including products by status, minted passports, and retrieval rates. Platform admins see all organizations; organization members see only their organization.

## Query parameters

- `startDate` string, date
- `endDate` string, date
- `applicationId` string, uuid

## Response `200`

DPP metrics retrieved successfully

- DppMetricsByOrgDto[]
  - `organizationId` string, uuid, required: Organization UUID
  - `organizationName` string, required: Organization display name
  - `applications` object[], required: Metrics for each DPP-enabled application in the organization
    - `applicationId` string, uuid, required: Application UUID
    - `applicationName` string, required: Application display name
    - `metrics` object, required: DPP metrics for this application
      - `totalOwned` integer, required: Total number of passports with an assigned owner (minted to an account)
      - `totalMultiOwners` integer, required: Total number of accounts that own more than one passport
      - `totalPassports` integer, required: Total number of passport items for this application
      - `totalAccounts` integer, required: Total number of accounts for this application
      - `totalActiveUsers` integer, required: Total number of distinct users with a wallet quota event in the date range
      - `trustScoreAverage` integer, nullable, required: Mean Trust Score (0–100, ADR 0093) of the application's model passports, a snapshot of the current catalogue that ignores the date range. Only computed when the request is scoped to one application (`applicationId`); null otherwise, and null when the application has no model passport.
      - `trustScoreDimensions` object, nullable, required: How `trustScoreAverage` splits across the three dimensions of ADR 0093; the three always add up to `trustScoreAverage`. Null whenever `trustScoreAverage` is null.
        - `completeness` integer, required: Mean points earned on the completeness dimension (share of the applicable fields filled in), out of its 40-point weight.
        - `richness` integer, required: Mean points earned on the richness dimension (extracted characteristics, saturating), out of its 20-point weight.
        - `signature` integer, required: Mean points earned on the signature dimension (certified passports), out of its 40-point weight.

## Other responses

- `401`: Unauthorized
- `403`: Metrics access denied

---

[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)
