Skip to main content

List verification history

GET 
/v3/config/digital-wallet/openid/sdjwt/verification/history

Lists verification exchange records (V3). Each represents a single OpenID4VP verification lifecycle.

Request​

Query Parameters

    offset integerrequired

    Number of records to skip for pagination.

    limit integerrequired

    Default value: 10

    Maximum number of records to return per page.

    status string

    Possible values: [request_sent, request_received, presentation_acked]

    Filter presentation exchange records by their OpenID4VP verification lifecycle status.

    presentationDefinitionId stringrequired

    Filter by presentation definition identifier to retrieve OpenID4VP verification records for a specific verification template.

    individualId stringrequired

    Filter by individual identifier to retrieve records associated with a specific individual.

    mapperId stringrequired

    Filter by mapper identifier to retrieve records linked to a specific individual mapping.

    search stringrequired

    Search term to filter results by

    sortOrder stringrequired

    Possible values: [desc, asc]

    Default value: desc

    Sort order for the returned records (ascending or descending).

Responses​

Verification history listed successfully

Response Headers
    Schema
      verificationHistory object[]
    • Array [
      • presentationExchangeId stringrequired

      Unique identifier for the verification exchange record, tracking the full lifecycle of a single OpenID for Verifiable Presentation (OpenID4VP) verification request.

      vpTokenQrCode stringrequired

      OpenID4VP Authorization Request URI encoded for QR code display or deep link. The holder's wallet scans or clicks this to initiate the presentation flow.

      presentationSubmission objectrequired

      Wrapper containing the Presentation Submission object received from the holder's wallet.

      presentation_submission objectrequired

      DIF Presentation Exchange Submission object mapping the holder's credentials to the verifier's requirements.

      definition_id stringrequired

      Identifier of the Presentation Definition that this submission fulfills.

      descriptor_map object[]required

      Array of Descriptor Map entries mapping each requested credential to its location in the Verifiable Presentation.

    • Array [
      • format stringrequired

      Credential format of the matched credential (e.g. jwt_vc_json, dc+sd-jwt, mso_mdoc).

      id stringrequired

      Identifier of the Input Descriptor from the Presentation Definition that this entry satisfies.

      path stringrequired

      JSONPath expression pointing to the Verifiable Credential within the Verifiable Presentation token.

      path_nested objectrequired

      Nested path descriptor for credentials wrapped in envelope formats (e.g. JWT inside a VP JWT).

      format stringrequired

      Credential format of the nested credential (e.g. jwt_vc_json, dc+sd-jwt, mso_mdoc).

      id stringrequired

      Identifier of the Input Descriptor from the Presentation Definition that this nested entry satisfies.

      path stringrequired

      JSONPath expression pointing to the credential within the nested envelope.

    • ]
      • id stringrequired

      Unique identifier for this Presentation Submission.

      status stringrequired

      Possible values: [request_sent, request_received, presentation_acked]

      Lifecycle status of the verification exchange:

      1. request_sent: The OpenID4VP Authorization Request has been created and is waiting for the holder.
      2. request_received: The holder's wallet has received/scanned the Authorization Request.
      3. presentation_acked: The holder has submitted the Verifiable Presentation and the verifier has processed it.
      verified booleanrequired

      Result of verifying the Verifiable Presentation: validates cryptographic signatures, credential status, and the Presentation Submission against the Presentation Definition.

      createdAt numberrequired

      Unix timestamp (in seconds) when this verification record was created.

      updatedAt numberrequired

      Unix timestamp (in seconds) when this verification record was last modified.

      presentationDefinitionId stringrequired

      Identifier of the presentation definition used for this verification request.

      holder objectrequired

      Contains the metadata describing a holder. For e.g. Name, location, logo e.t.c

      name stringrequired

      Identifier of the holder. For .e.g. DID or Name obtained from client metadata if available.

      walletUnitAttestation string

      Wallet Unit Attestation credential presented by the holder during the verification flow.

      walletUnitAttestationPoP string

      Proof of Possession for the holder's Wallet Unit Attestation.

      walletUnitAttestationVerified boolean

      Indicates whether the holder's Wallet Unit Attestation was successfully verified.

      presentation object[]

      Array of decoded credential objects presented by the holder.

      vpTokenResponse string[]required

      Array of Verifiable Presentation JWTs received from the holder.

      transactionData object

      Transaction data confirmed by the holder during the presentation flow.

      property name* any

      Transaction data confirmed by the holder during the presentation flow.

      transactionDataBase64 string

      Base64-encoded transaction data included in the presentation.

      presentationValidity object[]

      Array of validation results for each credential in the presentation, including signature verification, expiry checks, and revocation status.

      walletUnitValidity object[]

      Array of validation results for the holder's Wallet Unit Attestation.

      clientIdScheme string

      Possible values: [redirect_uri, did, verifier_attestation, x509_san_dns]

      Client ID scheme used by the verifier in the OpenID4VP Authorization Request.

      directPostRedirectUri string

      URI the wallet redirects to after posting the Authorization Response.

      responseMode string

      Possible values: [direct_post, direct_post.jwt]

      OpenID4VP response mode used: direct_post or direct_post.jwt.

      verifierAttestation string

      Verifier Attestation JWT sent to the holder, proving the verifier's authorization.

      individualId string

      Identifier of the individual the verification request was sent to.

      mapperId string

      Mapper identifier linking the verification to an external individual record.

      dataAgreement object

      Data agreement referencing the terms governing this verification.

      signatureStamp boolean

      When false, the signature stamp is hidden in signed PDFs.

      signatureCoordinate number[]

      Possible values: >= 4, <= 4

      Coordinates for signature placement in signed PDFs as [x1, y1, x2, y2].

      files object[]

      List of files generated during the verification, including signed and unsigned PDF documents.

    • Array [
      • credentialId string

      Identifier of the credential associated with this file.

      error stringnullable

      Error code if signing failed, null otherwise.

      errorDescription stringnullable

      Detailed error message if signing failed, null otherwise.

      signedFile uri

      URL of the signed PDF file.

      unsignedFile uri

      URL of the unsigned PDF file.

    • ]
    • ]
      • pagination object
      currentPage integer

      Current page number

      totalItems integer

      Total number of items available

      totalPages integer

      Total number of pages based on limit

      limit integer

      Number of items per page

      hasPrevious boolean

      Indicates if there's a previous page

      hasNext boolean

      Indicates if there's a next page

    Loading...
    Last updated on