Issuer statistics

Read credential definition statistics

GET/v4/config/ows/issuer/credential-definitions/{definitionId}/statistics

Returns the counts of the issuance histories of one credential definition (in progress, expired, denied, issued, revoked) and of its signed credentials, in the buckets of Read issuer statistics. The issuanceCount of the definition in List credential definitions is the issuanceHistory.total of this answer. The counts can be some seconds late.

Language of the request sample

curl 'https://demo-api.igrant.io/v4/config/ows/issuer/credential-definitions/{definitionId}/statistics' \
  -H 'Authorization: ApiKey <your-api-key>'

{
  "issuanceHistory": {
    "total": 1,
    "inProgress": 0,
    "expired": 0,
    "denied": 0,
    "issued": {
      "total": 1,
      "unconfirmed": 1,
      "confirmedByWallet": 0,
      "deletedByHolder": 0
    },
    "revoked": 0
  },
  "credentials": {
    "signed": 1,
    "reissues": 0
  },
  "updatedAt": "2026-11-08T14:42:11Z"
}

Authorizations

Authorizationstringheaderrequired
Your API key with the prefix ApiKey: ApiKey <your-api-key>. Get an API key.
Scope:credential-definitions:read

Path parameters

definitionIdstringrequired
The id of the credential definition (credentialDefinitionId), from List credential definitions.

Response

application/json

The counts of the credential definition.

issuanceHistoryobject
The issuance histories in each bucket.
credentialsobject
The credentials that the issuer signed.
updatedAtstring<date-time> | null
When the counts last changed (RFC 3339, UTC), or null before the first count.
Example:"2026-11-05T04:37:10Z"