Verifier Requests

List verifier presentation requests

get

List verifier presentation requests managed by the Wallet. The list can be filtered, sorted, and paginated by using the available query parameters. Filtering by name is also supported to easily retrieve requests with a specific name or keyword.

Authorizations

bearerAuthmutualTLS

AuthorizationstringOptional

Bearer authentication header of the form Bearer <token>.

Query parameters

orderstring · enumOptionalPossible values:

order_bystring · enumOptionalPossible values:

per_pageinteger · min: 1 · max: 50OptionalDefault: 50

pageinteger · min: 1Optional

searchstringOptional

Filter presentation requests by name.

Responses

200

Presentation requests successfully loaded

application/json

400

Invalid query params

application/json

get/verifier/requests

HTTPcURLJavaScriptPython

GET /verifier/requests HTTP/1.1
Host: zyfla-wallet-sandbox.meeco.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "presentation_requests": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "name": "Employee ID check",
      "presentation_definition": {
        "id": "text",
        "input_descriptors": [
          {
            "constraints": {
              "fields": [
                {
                  "filter": {
                    "ANY_ADDITIONAL_PROPERTY": "anything"
                  },
                  "path": "[\"$.issuer\", \"$.vc.issuer\", \"$.iss\"]"
                }
              ],
              "limit_disclosure": "required"
            },
            "format": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            },
            "group": [
              "text"
            ],
            "id": "text",
            "name": "text",
            "purpose": "text"
          }
        ],
        "submission_requirements": [
          {
            "count": 1,
            "from": "text",
            "name": "text",
            "rule": "pick"
          }
        ]
      },
      "dcql_query": {
        "credentials": [
          {
            "id": "text",
            "format": "dc+sd-jwt",
            "multiple": true,
            "meta": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            },
            "trusted_authorities": [
              {
                "type": "text",
                "values": [
                  "text"
                ]
              }
            ],
            "require_cryptographic_holder_binding": true,
            "claims": [
              {
                "id": "text",
                "namespace": "text",
                "claim_name": "text",
                "path": [],
                "values": [],
                "intent_to_retain": true
              }
            ],
            "claim_sets": [
              [
                "text"
              ]
            ]
          }
        ],
        "credential_sets": [
          {
            "options": [
              [
                "text"
              ]
            ],
            "required": true
          }
        ]
      },
      "status": "pending",
      "response_type": "vp_token",
      "response_mode": "direct_post",
      "state": null,
      "nonce": "text",
      "expires_at": "2026-07-13T21:29:53.411Z",
      "verifier_redirect_uri": null,
      "expected_origins": [
        "text"
      ],
      "created_at": "2026-07-13T21:29:53.411Z",
      "updated_at": "2026-07-13T21:29:53.411Z"
    }
  ],
  "meta": {
    "order_by": "name",
    "order": "ASC",
    "order_from_params": true,
    "per_page": 10,
    "per_page_from_params": true,
    "records_count": 100,
    "page": 1,
    "page_count": 10
  }
}

Create verifier presentation request

post

Create a verifier presentation request.

This endpoint creates and stores a presentation request that can later be listed, fetched, and correlated with received presentation responses.

All presentation requests expire. Expiration is controlled by runtime setting verifier.request_policy.default_expiry with a default value of 7 days.

Supported Standards

• OpenID4VP 1.0

Authorizations

bearerAuthmutualTLS

AuthorizationstringOptional

Bearer authentication header of the form Bearer <token>.

Body

application/json

namestringOptional

Optional custom name for the presentation request. If omitted, the presentation template name is used.

Example: Employee ID check

presentation_template_idstringRequired

Identifier of the presentation template to use for the request.

Example: my-presentation-template

response_modestring · enumOptional

Determines how the wallet submits the authorization response.

Possible values:

verifier_redirect_uristringOptional

URI to redirect to after the wallet submits the authorization response.

Example: https://verifier.example.com/callback

expected_originsstring[] · min: 1Optional

List of expected origins for the Digital Credentials API response. At least one origin must be provided when specified.

Example: ["https://verifier.example.com"]

Responses

201

Presentation request successfully created

application/json

400

Invalid request payload

application/json

500Error

application/json

post/verifier/requests

HTTPcURLJavaScriptPython

POST /verifier/requests HTTP/1.1
Host: zyfla-wallet-sandbox.meeco.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 228

{
  "name": "Employee ID check",
  "presentation_template_id": "my-presentation-template",
  "response_mode": "direct_post",
  "verifier_redirect_uri": "https://verifier.example.com/callback",
  "expected_origins": [
    "https://verifier.example.com"
  ]
}

{
  "presentation_request": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Employee ID check",
    "presentation_definition": {
      "id": "text",
      "input_descriptors": [
        {
          "constraints": {
            "fields": [
              {
                "filter": {
                  "ANY_ADDITIONAL_PROPERTY": "anything"
                },
                "path": "[\"$.issuer\", \"$.vc.issuer\", \"$.iss\"]"
              }
            ],
            "limit_disclosure": "required"
          },
          "format": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "group": [
            "text"
          ],
          "id": "text",
          "name": "text",
          "purpose": "text"
        }
      ],
      "submission_requirements": [
        {
          "count": 1,
          "from": "text",
          "name": "text",
          "rule": "pick"
        }
      ]
    },
    "dcql_query": {
      "credentials": [
        {
          "id": "text",
          "format": "dc+sd-jwt",
          "multiple": true,
          "meta": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "trusted_authorities": [
            {
              "type": "text",
              "values": [
                "text"
              ]
            }
          ],
          "require_cryptographic_holder_binding": true,
          "claims": [
            {
              "id": "text",
              "namespace": "text",
              "claim_name": "text",
              "path": [],
              "values": [],
              "intent_to_retain": true
            }
          ],
          "claim_sets": [
            [
              "text"
            ]
          ]
        }
      ],
      "credential_sets": [
        {
          "options": [
            [
              "text"
            ]
          ],
          "required": true
        }
      ]
    },
    "status": "pending",
    "response_type": "vp_token",
    "response_mode": "direct_post",
    "state": null,
    "nonce": "text",
    "expires_at": "2026-07-13T21:29:53.411Z",
    "verifier_redirect_uri": null,
    "expected_origins": [
      "text"
    ],
    "created_at": "2026-07-13T21:29:53.411Z",
    "updated_at": "2026-07-13T21:29:53.411Z"
  }
}

Get verifier presentation request

get

Get a verifier presentation request by ID. The presentation request object contains necessary information for the wallet to proceed with presentation submission as well as metadata such as the linked presentation template and stored presentation responses if any.

Authorizations

bearerAuthmutualTLS

AuthorizationstringOptional

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Responses

200

Presentation request successfully loaded

application/json

400

Invalid path param

application/json

404

Presentation request not found

application/json

get/verifier/requests/{id}

HTTPcURLJavaScriptPython

GET /verifier/requests/{id} HTTP/1.1
Host: zyfla-wallet-sandbox.meeco.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "presentation_request": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "name": "Employee ID check",
    "presentation_definition": {
      "id": "text",
      "input_descriptors": [
        {
          "constraints": {
            "fields": [
              {
                "filter": {
                  "ANY_ADDITIONAL_PROPERTY": "anything"
                },
                "path": "[\"$.issuer\", \"$.vc.issuer\", \"$.iss\"]"
              }
            ],
            "limit_disclosure": "required"
          },
          "format": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "group": [
            "text"
          ],
          "id": "text",
          "name": "text",
          "purpose": "text"
        }
      ],
      "submission_requirements": [
        {
          "count": 1,
          "from": "text",
          "name": "text",
          "rule": "pick"
        }
      ]
    },
    "dcql_query": {
      "credentials": [
        {
          "id": "text",
          "format": "dc+sd-jwt",
          "multiple": true,
          "meta": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          },
          "trusted_authorities": [
            {
              "type": "text",
              "values": [
                "text"
              ]
            }
          ],
          "require_cryptographic_holder_binding": true,
          "claims": [
            {
              "id": "text",
              "namespace": "text",
              "claim_name": "text",
              "path": [],
              "values": [],
              "intent_to_retain": true
            }
          ],
          "claim_sets": [
            [
              "text"
            ]
          ]
        }
      ],
      "credential_sets": [
        {
          "options": [
            [
              "text"
            ]
          ],
          "required": true
        }
      ]
    },
    "status": "pending",
    "response_type": "vp_token",
    "response_mode": "direct_post",
    "state": null,
    "nonce": "text",
    "expires_at": "2026-07-13T21:29:53.411Z",
    "verifier_redirect_uri": null,
    "expected_origins": [
      "text"
    ],
    "created_at": "2026-07-13T21:29:53.411Z",
    "updated_at": "2026-07-13T21:29:53.411Z"
  }
}

Delete verifier presentation request

delete

Delete a verifier presentation request by ID. Deleted presentation requests can no longer be retrieved, and new presentation responses cannot be submitted against them. Linked submission will be removed together with the deleted presentation request. Ensure to review the implications before deleting a presentation request.

Authorizations

bearerAuthmutualTLS

AuthorizationstringOptional

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Responses

204

Presentation request deleted

No content

400

Invalid path param

application/json

404

Presentation request not found

application/json

delete/verifier/requests/{id}

HTTPcURLJavaScriptPython

DELETE /verifier/requests/{id} HTTP/1.1
Host: zyfla-wallet-sandbox.meeco.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content

List verifier presentation responses

get

List stored presentation responses for a verifier presentation request. The list can be filtered, sorted, and paginated by using the available query parameters. Sorting by created_at or last_verified_at is supported to easily retrieve responses based on their creation time or verification time if they have been verified by the Wallet.

Authorizations

bearerAuthmutualTLS

AuthorizationstringOptional

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

Query parameters

orderstring · enumOptionalPossible values:

order_bystring · enumOptionalPossible values:

per_pageinteger · min: 1 · max: 50OptionalDefault: 50

pageinteger · min: 1Optional

Responses

200

Presentation responses successfully loaded

application/json

400

Invalid path param

application/json

404

Presentation request or response not found

application/json

get/verifier/requests/{id}/responses

HTTPcURLJavaScriptPython

GET /verifier/requests/{id}/responses HTTP/1.1
Host: zyfla-wallet-sandbox.meeco.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "presentation_responses": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "presentation_request_id": null,
      "vp_token": null,
      "presentation_submission": null,
      "verification_result": {
        "checks": [
          "format"
        ],
        "warnings": [
          {
            "error": "text",
            "message": "text",
            "extra_info": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          }
        ],
        "errors": [
          {
            "error": "text",
            "message": "text",
            "extra_info": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          }
        ],
        "id_token": {
          "checks": [
            "format"
          ],
          "warnings": [
            {
              "error": "text",
              "message": "text",
              "extra_info": {
                "ANY_ADDITIONAL_PROPERTY": "anything"
              }
            }
          ],
          "errors": [
            {
              "error": "text",
              "message": "text",
              "extra_info": {
                "ANY_ADDITIONAL_PROPERTY": "anything"
              }
            }
          ]
        },
        "vp_token": [
          {
            "checks": [
              "format"
            ],
            "warnings": [
              {
                "error": "text",
                "message": "text",
                "extra_info": {
                  "ANY_ADDITIONAL_PROPERTY": "anything"
                }
              }
            ],
            "errors": [
              {
                "error": "text",
                "message": "text",
                "extra_info": {
                  "ANY_ADDITIONAL_PROPERTY": "anything"
                }
              }
            ],
            "credentials": [
              {
                "id": "123e4567-e89b-12d3-a456-426614174000",
                "checks": [
                  "text"
                ],
                "warnings": [
                  {
                    "error": "text",
                    "message": "text",
                    "extra_info": {
                      "ANY_ADDITIONAL_PROPERTY": "anything"
                    }
                  }
                ],
                "errors": [
                  {
                    "error": "text",
                    "message": "text",
                    "extra_info": {
                      "ANY_ADDITIONAL_PROPERTY": "anything"
                    }
                  }
                ]
              }
            ]
          }
        ]
      },
      "last_verified_at": "2026-07-13T21:29:53.411Z",
      "created_at": "2026-07-13T21:29:53.411Z"
    }
  ],
  "meta": {
    "order_by": "name",
    "order": "ASC",
    "order_from_params": true,
    "per_page": 10,
    "per_page_from_params": true,
    "records_count": 100,
    "page": 1,
    "page_count": 10
  }
}

Get verifier presentation response

get

Get a stored presentation response for a verifier presentation request. The presentation response object contains the original submitted response information such as the Verifiable Presentation content and metadata such as the verification status and time if it has been verified by the Wallet.

Authorizations

bearerAuthmutualTLS

AuthorizationstringOptional

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

responseIdstring · uuidRequired

Responses

200

Presentation response successfully loaded

application/json

400

Invalid path param

application/json

404

Presentation request or response not found

application/json

get/verifier/requests/{id}/responses/{responseId}

HTTPcURLJavaScriptPython

GET /verifier/requests/{id}/responses/{responseId} HTTP/1.1
Host: zyfla-wallet-sandbox.meeco.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "presentation_response": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "presentation_request_id": null,
    "vp_token": null,
    "presentation_submission": null,
    "verification_result": {
      "checks": [
        "format"
      ],
      "warnings": [
        {
          "error": "text",
          "message": "text",
          "extra_info": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        }
      ],
      "errors": [
        {
          "error": "text",
          "message": "text",
          "extra_info": {
            "ANY_ADDITIONAL_PROPERTY": "anything"
          }
        }
      ],
      "id_token": {
        "checks": [
          "format"
        ],
        "warnings": [
          {
            "error": "text",
            "message": "text",
            "extra_info": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          }
        ],
        "errors": [
          {
            "error": "text",
            "message": "text",
            "extra_info": {
              "ANY_ADDITIONAL_PROPERTY": "anything"
            }
          }
        ]
      },
      "vp_token": [
        {
          "checks": [
            "format"
          ],
          "warnings": [
            {
              "error": "text",
              "message": "text",
              "extra_info": {
                "ANY_ADDITIONAL_PROPERTY": "anything"
              }
            }
          ],
          "errors": [
            {
              "error": "text",
              "message": "text",
              "extra_info": {
                "ANY_ADDITIONAL_PROPERTY": "anything"
              }
            }
          ],
          "credentials": [
            {
              "id": "123e4567-e89b-12d3-a456-426614174000",
              "checks": [
                "text"
              ],
              "warnings": [
                {
                  "error": "text",
                  "message": "text",
                  "extra_info": {
                    "ANY_ADDITIONAL_PROPERTY": "anything"
                  }
                }
              ],
              "errors": [
                {
                  "error": "text",
                  "message": "text",
                  "extra_info": {
                    "ANY_ADDITIONAL_PROPERTY": "anything"
                  }
                }
              ]
            }
          ]
        }
      ]
    },
    "last_verified_at": "2026-07-13T21:29:53.411Z",
    "created_at": "2026-07-13T21:29:53.411Z"
  }
}

Delete verifier presentation response

delete

Delete a stored presentation response for a verifier presentation request. Deleted presentation responses can no longer be retrieved. Ensure to review the implications before deleting a presentation response, especially if it has been verified by the Wallet and shared with verifiers.

Authorizations

bearerAuthmutualTLS

AuthorizationstringOptional

Bearer authentication header of the form Bearer <token>.

Path parameters

idstring · uuidRequired

responseIdstring · uuidRequired

Responses

204

Presentation response deleted

No content

400

Invalid path param

application/json

404

Presentation request or response not found

application/json

delete/verifier/requests/{id}/responses/{responseId}

HTTPcURLJavaScriptPython

DELETE /verifier/requests/{id}/responses/{responseId} HTTP/1.1
Host: zyfla-wallet-sandbox.meeco.cloud
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

No content