# VP Query

## GET /api/v1/verifier/vp-queries

> Retrieves all VP query configurations.

```json
{"openapi":"3.0.0","info":{"title":"verifier-service","version":"1.0.0-rc1"},"servers":[{"url":"/"}],"security":[{"clientSecret":[]}],"components":{"securitySchemes":{"clientSecret":{"type":"apiKey","name":"x-client-secret","in":"header"}},"schemas":{"VpQueryConfiguration":{"description":"Entity representing a Verifiable Presentation (VP) query configuration.\n\nVP queries define what credentials a verifier is requesting from a user.\nThese configurations can be reused across multiple authorization requests,\nallowing for standardized verification processes.","properties":{"id":{"type":"string","description":"Unique identifier for the VP query configuration.\nAutomatically generated as a UUID."},"queryBody":{"items":{"$ref":"#/components/schemas/VPQueryParams"},"type":"array","description":"The body of the VP query as a JSON array.\nContains the parameters that define what credentials are being requested,\nincluding types, formats, and constraints."},"createdAt":{"type":"number","format":"double","description":"Timestamp when this VP query configuration was created.\nStored as a bigint representing milliseconds since the Unix epoch."}},"required":["id","queryBody"],"type":"object","additionalProperties":false},"VPQueryParams":{"properties":{"fields":{"items":{"$ref":"#/components/schemas/InputDescriptorField"},"type":"array","description":"List of descriptor fields that define paths and optional filters"}},"required":["fields"],"type":"object","description":"Parameters for querying Verifiable Presentations.\nContains fields to specify which parts of a credential to query\nand optional filters to apply."},"InputDescriptorField":{"properties":{"filter":{"$ref":"#/components/schemas/JSONSchema7","description":"Optional JSON Schema that values must conform to"},"path":{"items":{"type":"string"},"type":"array","description":"Array of JSONPath expressions to locate values in the credential"}},"required":["path"],"type":"object","description":"Describes a field within an input descriptor.\nUsed to specify which paths to extract from a credential\nand optional JSON Schema filter to validate the values."},"JSONSchema7":{"properties":{"$id":{"type":"string"},"$ref":{"type":"string"},"$schema":{"$ref":"#/components/schemas/JSONSchema7Version"},"$comment":{"type":"string"},"$defs":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"type":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7TypeName"},{"items":{"$ref":"#/components/schemas/JSONSchema7TypeName"},"type":"array"}]},"enum":{"items":{"$ref":"#/components/schemas/JSONSchema7Type"},"type":"array"},"const":{"$ref":"#/components/schemas/JSONSchema7Type"},"multipleOf":{"type":"number","format":"double"},"maximum":{"type":"number","format":"double"},"exclusiveMaximum":{"type":"number","format":"double"},"minimum":{"type":"number","format":"double"},"exclusiveMinimum":{"type":"number","format":"double"},"maxLength":{"type":"number","format":"double"},"minLength":{"type":"number","format":"double"},"pattern":{"type":"string"},"items":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7Definition"},{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"}]},"additionalItems":{"$ref":"#/components/schemas/JSONSchema7Definition"},"maxItems":{"type":"number","format":"double"},"minItems":{"type":"number","format":"double"},"uniqueItems":{"type":"boolean"},"contains":{"$ref":"#/components/schemas/JSONSchema7Definition"},"maxProperties":{"type":"number","format":"double"},"minProperties":{"type":"number","format":"double"},"required":{"items":{"type":"string"},"type":"array"},"properties":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"patternProperties":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"dependencies":{"properties":{},"additionalProperties":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7Definition"},{"items":{"type":"string"},"type":"array"}]},"type":"object"},"propertyNames":{"$ref":"#/components/schemas/JSONSchema7Definition"},"if":{"$ref":"#/components/schemas/JSONSchema7Definition"},"then":{"$ref":"#/components/schemas/JSONSchema7Definition"},"else":{"$ref":"#/components/schemas/JSONSchema7Definition"},"allOf":{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"},"anyOf":{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"},"oneOf":{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"},"not":{"$ref":"#/components/schemas/JSONSchema7Definition"},"format":{"type":"string"},"contentMediaType":{"type":"string"},"contentEncoding":{"type":"string"},"definitions":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"title":{"type":"string"},"description":{"type":"string"},"default":{"$ref":"#/components/schemas/JSONSchema7Type"},"readOnly":{"type":"boolean"},"writeOnly":{"type":"boolean"}},"type":"object","additionalProperties":false},"JSONSchema7Version":{"type":"string","description":"Meta schema\n\nRecommended values:\n- 'http://json-schema.org/schema#'\n- 'http://json-schema.org/hyper-schema#'\n- 'http://json-schema.org/draft-07/schema#'\n- 'http://json-schema.org/draft-07/hyper-schema#'"},"JSONSchema7Definition":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7"},{"type":"boolean"}],"description":"JSON Schema v7"},"JSONSchema7TypeName":{"type":"string","enum":["string","number","integer","boolean","object","array","null"],"description":"Primitive type"},"JSONSchema7Type":{"anyOf":[{"type":"string"},{"type":"number","format":"double"},{"type":"boolean"},{"$ref":"#/components/schemas/JSONSchema7Object"},{"$ref":"#/components/schemas/JSONSchema7Array"}],"nullable":true,"description":"Primitive type"},"JSONSchema7Object":{"properties":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Type"}},"JSONSchema7Array":{"properties":{},"type":"object","additionalProperties":false}}},"paths":{"/api/v1/verifier/vp-queries":{"get":{"operationId":"GetVpQueries","responses":{"200":{"description":"Found","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/VpQueryConfiguration"},"type":"array"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{}}}}},"description":"Retrieves all VP query configurations.","tags":["VP Query"],"parameters":[]}}}}
```

## POST /api/v1/verifier/vp-queries

> Creates a new VP query configuration.

```json
{"openapi":"3.0.0","info":{"title":"verifier-service","version":"1.0.0-rc1"},"servers":[{"url":"/"}],"security":[{"clientSecret":[]}],"components":{"securitySchemes":{"clientSecret":{"type":"apiKey","name":"x-client-secret","in":"header"}},"schemas":{"VpQueryConfiguration":{"description":"Entity representing a Verifiable Presentation (VP) query configuration.\n\nVP queries define what credentials a verifier is requesting from a user.\nThese configurations can be reused across multiple authorization requests,\nallowing for standardized verification processes.","properties":{"id":{"type":"string","description":"Unique identifier for the VP query configuration.\nAutomatically generated as a UUID."},"queryBody":{"items":{"$ref":"#/components/schemas/VPQueryParams"},"type":"array","description":"The body of the VP query as a JSON array.\nContains the parameters that define what credentials are being requested,\nincluding types, formats, and constraints."},"createdAt":{"type":"number","format":"double","description":"Timestamp when this VP query configuration was created.\nStored as a bigint representing milliseconds since the Unix epoch."}},"required":["id","queryBody"],"type":"object","additionalProperties":false},"VPQueryParams":{"properties":{"fields":{"items":{"$ref":"#/components/schemas/InputDescriptorField"},"type":"array","description":"List of descriptor fields that define paths and optional filters"}},"required":["fields"],"type":"object","description":"Parameters for querying Verifiable Presentations.\nContains fields to specify which parts of a credential to query\nand optional filters to apply."},"InputDescriptorField":{"properties":{"filter":{"$ref":"#/components/schemas/JSONSchema7","description":"Optional JSON Schema that values must conform to"},"path":{"items":{"type":"string"},"type":"array","description":"Array of JSONPath expressions to locate values in the credential"}},"required":["path"],"type":"object","description":"Describes a field within an input descriptor.\nUsed to specify which paths to extract from a credential\nand optional JSON Schema filter to validate the values."},"JSONSchema7":{"properties":{"$id":{"type":"string"},"$ref":{"type":"string"},"$schema":{"$ref":"#/components/schemas/JSONSchema7Version"},"$comment":{"type":"string"},"$defs":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"type":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7TypeName"},{"items":{"$ref":"#/components/schemas/JSONSchema7TypeName"},"type":"array"}]},"enum":{"items":{"$ref":"#/components/schemas/JSONSchema7Type"},"type":"array"},"const":{"$ref":"#/components/schemas/JSONSchema7Type"},"multipleOf":{"type":"number","format":"double"},"maximum":{"type":"number","format":"double"},"exclusiveMaximum":{"type":"number","format":"double"},"minimum":{"type":"number","format":"double"},"exclusiveMinimum":{"type":"number","format":"double"},"maxLength":{"type":"number","format":"double"},"minLength":{"type":"number","format":"double"},"pattern":{"type":"string"},"items":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7Definition"},{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"}]},"additionalItems":{"$ref":"#/components/schemas/JSONSchema7Definition"},"maxItems":{"type":"number","format":"double"},"minItems":{"type":"number","format":"double"},"uniqueItems":{"type":"boolean"},"contains":{"$ref":"#/components/schemas/JSONSchema7Definition"},"maxProperties":{"type":"number","format":"double"},"minProperties":{"type":"number","format":"double"},"required":{"items":{"type":"string"},"type":"array"},"properties":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"patternProperties":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"dependencies":{"properties":{},"additionalProperties":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7Definition"},{"items":{"type":"string"},"type":"array"}]},"type":"object"},"propertyNames":{"$ref":"#/components/schemas/JSONSchema7Definition"},"if":{"$ref":"#/components/schemas/JSONSchema7Definition"},"then":{"$ref":"#/components/schemas/JSONSchema7Definition"},"else":{"$ref":"#/components/schemas/JSONSchema7Definition"},"allOf":{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"},"anyOf":{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"},"oneOf":{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"},"not":{"$ref":"#/components/schemas/JSONSchema7Definition"},"format":{"type":"string"},"contentMediaType":{"type":"string"},"contentEncoding":{"type":"string"},"definitions":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"title":{"type":"string"},"description":{"type":"string"},"default":{"$ref":"#/components/schemas/JSONSchema7Type"},"readOnly":{"type":"boolean"},"writeOnly":{"type":"boolean"}},"type":"object","additionalProperties":false},"JSONSchema7Version":{"type":"string","description":"Meta schema\n\nRecommended values:\n- 'http://json-schema.org/schema#'\n- 'http://json-schema.org/hyper-schema#'\n- 'http://json-schema.org/draft-07/schema#'\n- 'http://json-schema.org/draft-07/hyper-schema#'"},"JSONSchema7Definition":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7"},{"type":"boolean"}],"description":"JSON Schema v7"},"JSONSchema7TypeName":{"type":"string","enum":["string","number","integer","boolean","object","array","null"],"description":"Primitive type"},"JSONSchema7Type":{"anyOf":[{"type":"string"},{"type":"number","format":"double"},{"type":"boolean"},{"$ref":"#/components/schemas/JSONSchema7Object"},{"$ref":"#/components/schemas/JSONSchema7Array"}],"nullable":true,"description":"Primitive type"},"JSONSchema7Object":{"properties":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Type"}},"JSONSchema7Array":{"properties":{},"type":"object","additionalProperties":false},"CreateVpQueryRequestDto":{"description":"DTO for creating a VP (Verifiable Presentation) query\n\nContains validation to ensure the input data is a properly formatted\nquery for verifying presentations (VP Query).","properties":{"query":{"items":{"$ref":"#/components/schemas/VPQueryParams"},"type":"array","description":"Array of VPQueryParams"}},"required":["query"],"type":"object","additionalProperties":false}}},"paths":{"/api/v1/verifier/vp-queries":{"post":{"operationId":"CreateVpQuery","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpQueryConfiguration"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{}}}}},"description":"Creates a new VP query configuration.","tags":["VP Query"],"parameters":[],"requestBody":{"description":"- Contains the query parameters for verifiable presentation verification\nThe query property should contain an array of VP query configurations that define\nwhat credentials and claims are required for successful verification.","required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVpQueryRequestDto","description":"- Contains the query parameters for verifiable presentation verification\nThe query property should contain an array of VP query configurations that define\nwhat credentials and claims are required for successful verification."}}}}}}}}
```

## GET /api/v1/verifier/vp-queries/{id}

> Retrieves a VP query configuration by its ID.

```json
{"openapi":"3.0.0","info":{"title":"verifier-service","version":"1.0.0-rc1"},"servers":[{"url":"/"}],"security":[{"clientSecret":[]}],"components":{"securitySchemes":{"clientSecret":{"type":"apiKey","name":"x-client-secret","in":"header"}},"schemas":{"VpQueryConfiguration":{"description":"Entity representing a Verifiable Presentation (VP) query configuration.\n\nVP queries define what credentials a verifier is requesting from a user.\nThese configurations can be reused across multiple authorization requests,\nallowing for standardized verification processes.","properties":{"id":{"type":"string","description":"Unique identifier for the VP query configuration.\nAutomatically generated as a UUID."},"queryBody":{"items":{"$ref":"#/components/schemas/VPQueryParams"},"type":"array","description":"The body of the VP query as a JSON array.\nContains the parameters that define what credentials are being requested,\nincluding types, formats, and constraints."},"createdAt":{"type":"number","format":"double","description":"Timestamp when this VP query configuration was created.\nStored as a bigint representing milliseconds since the Unix epoch."}},"required":["id","queryBody"],"type":"object","additionalProperties":false},"VPQueryParams":{"properties":{"fields":{"items":{"$ref":"#/components/schemas/InputDescriptorField"},"type":"array","description":"List of descriptor fields that define paths and optional filters"}},"required":["fields"],"type":"object","description":"Parameters for querying Verifiable Presentations.\nContains fields to specify which parts of a credential to query\nand optional filters to apply."},"InputDescriptorField":{"properties":{"filter":{"$ref":"#/components/schemas/JSONSchema7","description":"Optional JSON Schema that values must conform to"},"path":{"items":{"type":"string"},"type":"array","description":"Array of JSONPath expressions to locate values in the credential"}},"required":["path"],"type":"object","description":"Describes a field within an input descriptor.\nUsed to specify which paths to extract from a credential\nand optional JSON Schema filter to validate the values."},"JSONSchema7":{"properties":{"$id":{"type":"string"},"$ref":{"type":"string"},"$schema":{"$ref":"#/components/schemas/JSONSchema7Version"},"$comment":{"type":"string"},"$defs":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"type":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7TypeName"},{"items":{"$ref":"#/components/schemas/JSONSchema7TypeName"},"type":"array"}]},"enum":{"items":{"$ref":"#/components/schemas/JSONSchema7Type"},"type":"array"},"const":{"$ref":"#/components/schemas/JSONSchema7Type"},"multipleOf":{"type":"number","format":"double"},"maximum":{"type":"number","format":"double"},"exclusiveMaximum":{"type":"number","format":"double"},"minimum":{"type":"number","format":"double"},"exclusiveMinimum":{"type":"number","format":"double"},"maxLength":{"type":"number","format":"double"},"minLength":{"type":"number","format":"double"},"pattern":{"type":"string"},"items":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7Definition"},{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"}]},"additionalItems":{"$ref":"#/components/schemas/JSONSchema7Definition"},"maxItems":{"type":"number","format":"double"},"minItems":{"type":"number","format":"double"},"uniqueItems":{"type":"boolean"},"contains":{"$ref":"#/components/schemas/JSONSchema7Definition"},"maxProperties":{"type":"number","format":"double"},"minProperties":{"type":"number","format":"double"},"required":{"items":{"type":"string"},"type":"array"},"properties":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"patternProperties":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"dependencies":{"properties":{},"additionalProperties":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7Definition"},{"items":{"type":"string"},"type":"array"}]},"type":"object"},"propertyNames":{"$ref":"#/components/schemas/JSONSchema7Definition"},"if":{"$ref":"#/components/schemas/JSONSchema7Definition"},"then":{"$ref":"#/components/schemas/JSONSchema7Definition"},"else":{"$ref":"#/components/schemas/JSONSchema7Definition"},"allOf":{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"},"anyOf":{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"},"oneOf":{"items":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"array"},"not":{"$ref":"#/components/schemas/JSONSchema7Definition"},"format":{"type":"string"},"contentMediaType":{"type":"string"},"contentEncoding":{"type":"string"},"definitions":{"properties":{},"additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Definition"},"type":"object"},"title":{"type":"string"},"description":{"type":"string"},"default":{"$ref":"#/components/schemas/JSONSchema7Type"},"readOnly":{"type":"boolean"},"writeOnly":{"type":"boolean"}},"type":"object","additionalProperties":false},"JSONSchema7Version":{"type":"string","description":"Meta schema\n\nRecommended values:\n- 'http://json-schema.org/schema#'\n- 'http://json-schema.org/hyper-schema#'\n- 'http://json-schema.org/draft-07/schema#'\n- 'http://json-schema.org/draft-07/hyper-schema#'"},"JSONSchema7Definition":{"anyOf":[{"$ref":"#/components/schemas/JSONSchema7"},{"type":"boolean"}],"description":"JSON Schema v7"},"JSONSchema7TypeName":{"type":"string","enum":["string","number","integer","boolean","object","array","null"],"description":"Primitive type"},"JSONSchema7Type":{"anyOf":[{"type":"string"},{"type":"number","format":"double"},{"type":"boolean"},{"$ref":"#/components/schemas/JSONSchema7Object"},{"$ref":"#/components/schemas/JSONSchema7Array"}],"nullable":true,"description":"Primitive type"},"JSONSchema7Object":{"properties":{},"type":"object","additionalProperties":{"$ref":"#/components/schemas/JSONSchema7Type"}},"JSONSchema7Array":{"properties":{},"type":"object","additionalProperties":false}}},"paths":{"/api/v1/verifier/vp-queries/{id}":{"get":{"operationId":"GetVpQueryById","responses":{"200":{"description":"Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VpQueryConfiguration"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{}}}},"404":{"description":"Not Found"}},"description":"Retrieves a VP query configuration by its ID.","tags":["VP Query"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}]}}}}
```

## DELETE /api/v1/verifier/vp-queries/{id}

> Deletes a VP query configuration by its ID.

```json
{"openapi":"3.0.0","info":{"title":"verifier-service","version":"1.0.0-rc1"},"servers":[{"url":"/"}],"security":[{"clientSecret":[]}],"components":{"securitySchemes":{"clientSecret":{"type":"apiKey","name":"x-client-secret","in":"header"}}},"paths":{"/api/v1/verifier/vp-queries/{id}":{"delete":{"operationId":"DeleteVpQuery","responses":{"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{}}}}},"description":"Deletes a VP query configuration by its ID.","tags":["VP Query"],"parameters":[{"description":"- The UUID of the VP query configuration to delete","in":"path","name":"id","required":true,"schema":{"type":"string"}}]}}}}
```

## POST /api/v1/verifier/vp-queries/{id}/authorization-request

> Handles the creation of an authorization request using a VP Query.\
> Retrieves the presentation definition from the specified VP query and creates an authorization request.

```json
{"openapi":"3.0.0","info":{"title":"verifier-service","version":"1.0.0-rc1"},"servers":[{"url":"/"}],"security":[{"clientSecret":[]}],"components":{"securitySchemes":{"clientSecret":{"type":"apiKey","name":"x-client-secret","in":"header"}},"schemas":{"CreateAuthorizationRequestResponseDto":{"description":"Response for a successful authorization request creation","properties":{"request_uri":{"type":"string","description":"Request URI that can be used to create a QR code"},"qr_code_url":{"type":"string","description":"URL of the QR code that can be scanned by wallets"},"state":{"type":"string","description":"Random string to prevent CSRF attacks"},"nonce":{"type":"string","description":"Random string to ensure request uniqueness"},"validity":{"type":"number","format":"double","description":"Validity of the authorization request in seconds"}},"required":["request_uri","qr_code_url","state","nonce","validity"],"type":"object","additionalProperties":false},"CreateVpQueryAuthorizationRequestDto":{"description":"Request body for creating an authorization request using a VP query","properties":{"redirect_uri":{"type":"string","description":"Redirect URI to which the response will be sent"},"validity":{"type":"number","format":"double","description":"Validity of the authorization request in seconds"}},"required":["redirect_uri"],"type":"object","additionalProperties":false}}},"paths":{"/api/v1/verifier/vp-queries/{id}/authorization-request":{"post":{"operationId":"CreateVpQueryAuthorizationRequest","responses":{"201":{"description":"Created","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateAuthorizationRequestResponseDto"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{}}}}},"description":"Handles the creation of an authorization request using a VP Query.\nRetrieves the presentation definition from the specified VP query and creates an authorization request.","tags":["VP Query"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateVpQueryAuthorizationRequestDto"}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.empe.io/develop/verifier/api-reference/vp-query.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
