> For the complete documentation index, see [llms.txt](https://docs.meeco.me/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.meeco.me/openapi-docs/svx-api/open-id-4-verifiable-presentations.md).

# Open ID 4 Verifiable Presentations

## Submit authorization response

> Submit an authorization response to a previously created presentation request.\
> \
> This endpoint is called by the wallet to submit a Verifiable Presentation in response to an authorization request.\
> \
> The submission can be in one of two forms depending on the \`response\_mode\` of the original presentation request:\
> \- \`direct\_post\`: The \`vp\_token\` and \`presentation\_submission\` parameters are sent directly.\
> \- \`direct\_post.jwt\`: The \`response\` parameter contains a JWE-encrypted authorization response.\
> \
> Exactly one of \`vp\_token\` or \`response\` must be provided. Providing both or neither results in an error.\
> \
> If the original presentation request included a \`verifier\_redirect\_uri\`, it is returned in the response as \`redirect\_uri\`.\
> \
> \## Supported Standards\
> \
> \- \[OpenID4VP 1.0]\(<https://openid.net/specs/openid-4-verifiable-presentations-1\\_0.html#name-response>)<br>

```json
{"openapi":"3.1.0","info":{"title":"SVX Wallet API","version":"4.0.1"},"servers":[{"url":"https://zyfla-wallet-sandbox.meeco.cloud","description":"SVX Wallet deployment (relative)"}],"security":[],"paths":{"/verifier/requests/{id}/responses":{"post":{"summary":"Submit authorization response","description":"Submit an authorization response to a previously created presentation request.\n\nThis endpoint is called by the wallet to submit a Verifiable Presentation in response to an authorization request.\n\nThe submission can be in one of two forms depending on the `response_mode` of the original presentation request:\n- `direct_post`: The `vp_token` and `presentation_submission` parameters are sent directly.\n- `direct_post.jwt`: The `response` parameter contains a JWE-encrypted authorization response.\n\nExactly one of `vp_token` or `response` must be provided. Providing both or neither results in an error.\n\nIf the original presentation request included a `verifier_redirect_uri`, it is returned in the response as `redirect_uri`.\n\n## Supported Standards\n\n- [OpenID4VP 1.0](https://openid.net/specs/openid-4-verifiable-presentations-1_0.html#name-response)\n","operationId":"OpenIdVPController_submitAuthorizationResponse","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitAuthorizationResponsePayloadDto"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitAuthorizationResponseResponseDto"}}},"description":"Authorization response successfully submitted"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InvalidRequestError"}}},"description":""},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresentationRequestNotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}},"description":""}},"tags":["OpenID 4 Verifiable Presentations"]}}},"components":{"schemas":{"SubmitAuthorizationResponsePayloadDto":{"type":"object","description":"Exactly one of `vp_token` or `response` must be provided.\nUse `vp_token` with `direct_post` response mode.\nUse `response` (JWE) with `direct_post.jwt` response mode.\n","properties":{"vp_token":{"description":"The Verifiable Presentation token. Required when `response_mode` is `direct_post`.","type":"string"},"response":{"description":"The JWE-encrypted authorization response. Required when `response_mode` is `direct_post.jwt`.","type":"string"},"presentation_submission":{"description":"JSON string containing the presentation submission mapping between requested credentials and the VP token.","type":"string"},"state":{"description":"Opaque state value from the original presentation request.","type":"string"}}},"SubmitAuthorizationResponseResponseDto":{"type":"object","properties":{"redirect_uri":{"description":"The verifier redirect URI to follow after submission, if configured in the original presentation request.","type":"string"}}},"InvalidRequestError":{"properties":{"error":{"description":"Unique error identifier","enum":["invalid_request"],"type":"string"},"extra_info":{"description":"Object that may contain more information about the error","type":"object"},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"},"PresentationRequestNotFoundError":{"properties":{"error":{"description":"Unique error identifier","enum":["not_found"],"type":"string"},"extra_info":{"description":"Object that may contain more information about the error","type":"object"},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"},"InternalServerError":{"properties":{"error":{"description":"Unique error identifier","enum":["internal_server_error"],"type":"string"},"extra_info":{"description":"Object that may contain more information about the error","type":"object"},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"}}}}
```

## Get presentation request JWT

> Retrieve the signed JWT representation of a presentation request.\
> \
> This endpoint is typically called by the wallet after receiving an authorization request URI that contains a \`request\_uri\` parameter pointing to this endpoint.\
> \
> The response is the raw JWT string with content type \`application/oauth-authz-req+jwt\`.\
> \
> \## Supported Standards\
> \
> \- \[OpenID4VP 1.0]\(<https://openid.net/specs/openid-4-verifiable-presentations-1\\_0.html#name-authorization-request>)<br>

```json
{"openapi":"3.1.0","info":{"title":"SVX Wallet API","version":"4.0.1"},"servers":[{"url":"https://zyfla-wallet-sandbox.meeco.cloud","description":"SVX Wallet deployment (relative)"}],"security":[],"paths":{"/verifier/requests/{id}/jwt":{"get":{"summary":"Get presentation request JWT","description":"Retrieve the signed JWT representation of a presentation request.\n\nThis endpoint is typically called by the wallet after receiving an authorization request URI that contains a `request_uri` parameter pointing to this endpoint.\n\nThe response is the raw JWT string with content type `application/oauth-authz-req+jwt`.\n\n## Supported Standards\n\n- [OpenID4VP 1.0](https://openid.net/specs/openid-4-verifiable-presentations-1_0.html#name-authorization-request)\n","operationId":"OpenIdVPController_getPresentationRequestJwt","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"content":{"application/oauth-authz-req+jwt":{"schema":{"type":"string"}}},"description":"Presentation request JWT successfully loaded"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PresentationRequestNotFoundError"}}},"description":""},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InternalServerError"}}},"description":""}},"tags":["OpenID 4 Verifiable Presentations"]}}},"components":{"schemas":{"PresentationRequestNotFoundError":{"properties":{"error":{"description":"Unique error identifier","enum":["not_found"],"type":"string"},"extra_info":{"description":"Object that may contain more information about the error","type":"object"},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"},"InternalServerError":{"properties":{"error":{"description":"Unique error identifier","enum":["internal_server_error"],"type":"string"},"extra_info":{"description":"Object that may contain more information about the error","type":"object"},"message":{"description":"User friendly error message","type":"string"}},"required":["error","message","extra_info"],"type":"object"}}}}
```
