Skip to main content
Issuance

List issuance history

GET/v4/config/ows/issuer/issuance-history

Lists the issuance histories of the organisation, newest first, one page at a time. Each item is a summary; read the details with Read issuance history. Filter with offerId to get the issuance histories of one issue call (one for each credential configuration), or with status, revoked, the credential definition, the holder or the time of creation. To read the next page, send the nextCursor of the answer as cursor. The list leaves out the issuance histories that you deleted and those of a deleted credential definition. For the counts in buckets, use Read issuer statistics.

Authorizations

  • Authorizationstringheaderrequired

    Your API key with the prefix ApiKey: ApiKey <your-api-key>. Get an API key.

    Scope:issuances:read

Query parameters

  • limitinteger

    The most items in the page: 1 to 100, default 20. Another value gives HTTP 400.

    From 1 to 100.

    Default:20

  • cursorstring

    The nextCursor of the page before, to read the next page. Leave it out for the first page. Use it as it is: a changed cursor gives HTTP 400. Do not send it with offset (HTTP 400).

  • offsetinteger

    How many items come before the page: 0 to 10000. Use it only to jump to a page of a pager, then continue with the nextCursor of the answer. Do not send it with cursor (HTTP 400). Another value gives HTTP 400.

    From 0 to 10000.

  • includeTotalboolean

    true: the answer also has total and totalCapped, the number of items of the filtered list. Send it on the first page only, for a pager. Default false. Another value gives HTTP 400.

    Default:false

  • credentialDefinitionIdstring<uuid>

    Gives only the issuance histories of this credential definition. A value that is not a UUID gives HTTP 400.

  • credentialConfigurationIdstring

    Gives only the issuance histories of this credential configuration (its credentialConfigurationId, exact match).

  • offerIdstring

    Gives only the issuance histories of this credential offer (offer.offerId of the issue call, exact match): one for each credential configuration of the definition.

  • statusenum<string>[]

    Gives only the issuance histories with one of these statuses. Repeat the parameter (status=offer_sent&status=offer_retrieved) or send a comma-separated list. An unknown status gives HTTP 400.

    Available options:offer_sent,offer_retrieved,token_issued,credential_deferred,claims_supplied,credential_issued,credential_accepted,credential_deleted,denied,expired

  • revokedboolean

    true: only the revoked issuance histories. false: only those that are not revoked. Another value gives HTTP 400.

  • individualIdstring

    Gives only the records of this individual (the individualId of the request that made them).

  • mapperIdstring

    Gives only the records of the individual with this mapper id (the mapperId of the request that made them).

  • clientIdstring

    Gives only the issuance histories whose wallet client id (clientId) contains this text, in any case.

  • createdAfterstring<date-time>

    Gives only the issuance histories made at or after this time: RFC 3339 with its offset, for example 2026-11-01T00:00:00Z. A time without an offset gives HTTP 400.

  • createdBeforestring<date-time>

    Gives only the issuance histories made before this time (not at it): RFC 3339 with its offset, for example 2026-12-01T00:00:00Z. A time without an offset gives HTTP 400.

Response

application/json

One page of the issuance histories.

  • itemsobject[]

    The issuance histories of the page, newest first. Empty when no issuance history matches.

  • nextCursorstring | null

    The cursor of the next page, or null on the last page.

    Example:"eyJjIjoiMjAyNi0xMS0wNVQxMDowMDowMFoiLCJpIjoiNmIwZiJ9"

  • totalinteger

    The number of items of the filtered list, at most 10000. Only with includeTotal=true. When the list has more items, the value is 10000 and totalCapped is true.

    From 0 to 10000.

    Example:137

  • totalCappedboolean

    true when the filtered list has more than 10000 items: total then shows 10000. Only with includeTotal=true.

    Example:false