v8

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

OpenID4VCI Protocol

Get a credential offer (holder preview)

Fetch a public preview of an OpenID4VCI (OpenID for Verifiable Credential Issuance) credential offer by UUID. Use it to show the issuer, credential type, expiration, transaction-code requirement, and claim labels. This captured flow returns labels without claim values.

get/v1/credential-offers/{uuid}

Path parameters

uuidstring uuid required

Send the offer UUID.

Response

Didit returned the holder-facing offer preview.

expires_atstring date-time

You receive the timestamp when the offer expires.

formatstring

You receive the SD-JWT VC (Selective-Disclosure JWT Verifiable Credential) format value for this offer.

offer_idstring uuid

Use this UUID to identify the credential offer.

offer_uristring uri

Open this OpenID4VCI (OpenID for Verifiable Credential Issuance) credential-offer URI in a compatible wallet.

tx_code_lengthinteger

Render a transaction-code input with this many digits.

tx_code_requiredboolean

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

vctstring

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

Example response

{
  "claims": [
    {
      "label": "Given Name",
      "name": "given_name",
      "selective_disclosure": true
    },
    {
      "label": "Tier",
      "name": "tier",
      "selective_disclosure": true
    }
  ],
  "expires_at": "2026-07-02T23:43:33.649962+00:00",
  "format": "SD_JWT_VC",
  "issuer": {
    "did": "did:web:docs-capture-6clew6.didit.test",
    "domain": "http://localhost:8011/v1/issuers/docs-capture-6clew6",
    "id": "docs-capture-6clew6",
    "name": "docs-capture-6clew6"
  },
  "offer_id": "f7219265-039a-4c72-b2bd-54432bf443b3",
  "offer_uri": "openid-credential-offer://?credential_offer_uri=http%3A%2F%2Flocalhost%3A8011%2Fv1%2Fcredential-offers%2Ff7219265-039a-4c72-b2bd-54432bf443b3%2Foffer",
  "tx_code_length": 6,
  "tx_code_required": true,
  "vct": "AirlineLoyalty"
}