v8

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-05730512.7 KB
OpenID4VCI Protocol

List the tenant's credential offers.

List credential offers for your tenant. The response is a bare JSON array, so each documented field describes one offer object in that array. Use it to track pending and claimed OpenID4VCI (OpenID for Verifiable Credential Issuance) offers.

get/v1/credential-offers

Response

A bare JSON array of credential offer objects.

claimed_atstring date-time nullable

You receive the timestamp when the holder claimed the offer. You receive null while the offer is still pending.

claimed_bystring

You receive the holder identifier that claimed the offer. You receive an empty string until a holder claims it.

created_atstring date-time

You receive the timestamp when Didit created the offer.

email_sent_atstring date-time nullable

You receive the timestamp when Didit sent the claim email. You receive null when no email has been sent.

expires_atstring date-time

You receive the timestamp when the offer expires.

offer_idstring uuid

Use this UUID to fetch, accept, or resend the credential offer.

recipient_emailstring

You receive the email address associated with the offer. You receive an empty string when the offer has no email recipient.

schema_namestring

You receive the credential schema display name used by this offer.

statusstring

You receive the current offer status.

tx_code_requiredboolean

You receive true when the holder must enter a transaction code before issuance.

vctstring

You receive the VCT (Verifiable Credential Type) that this offer issues.

Example response

[
  {
    "created_at": "2026-07-02T23:51:57.514393+00:00",
    "expires_at": "2026-07-03T00:01:57.514340+00:00",
    "offer_id": "6ba6f012-900b-4cfa-8c3b-50498c90c640",
    "recipient_email": "holder@diditcapture.dev",
    "schema_name": "Loyalty Membership",
    "status": "pending",
    "tx_code_required": true,
    "vct": "AirlineLoyalty"
  }
]