---
title: "Get a proxy access request"
method: GET
path: "/QuestionnaireResponse/{id}"
---

# Get a proxy access request

`GET /QuestionnaireResponse/{id}`

## Overview
Retrieve a QuestionnaireResponse using its unique access request ID. This endpoint returns the full
QuestionnaireResponse document that was previously submitted.

## Request Requirements
A valid access request ID must be provided as a path parameter.

## Access modes

This endpoint supports the following access modes:
- Patient access
- Healthcare worker access
- Application-restricted access

## Sandbox test scenarios

You can test the following scenarios in our sandbox environment:

| Scenario                         | Request                                          | Response                                                      |
| -------------------------------- | ------------------------------------------------ | ------------------------------------------------------------- |
| Valid access request ID          | ID value: `156e1560-e532-4e2a-85ad-5aeff03dc43e` | HTTP Status 200 with QuestionnaireResponse                    |
| Invalid access request ID        | ID value:  `INVALID`                             | HTTP Status 400 with INVALID_IDENTIFIER_VALUE message         |
| Missing access request ID        | No ID path parameter                             | HTTP Status 405 with METHOD_NOT_ALLOWED message               |
| Non-existent access request ID   | ID value: `60d09b82-f4bb-41f9-b41e-767999b4ac9b` | HTTP Status 404 with QUESTIONNAIRE_RESPONSE_NOT_FOUND message |

### Sandbox constraints

The sandbox environment has the following constraints for this endpoint:

  - Request headers are not tested. For example, `X-Request-ID` and `X-Correlation-ID` are disregarded.

## Path parameters

- `id` string, uuid, required

## Headers

- `Authorization` string, ^Bearer\ [[:ascii:]]+$, required
- `X-Request-ID` string, uuid, required
- `X-Correlation-ID` string, uuid

## Response `200`

QuestionnaireResponse successfully retrieved.

## Other responses

- `4XX` — Errors will be returned for the first error encountered in the request. An error occurred as follows: | HTTP status | Error code | Description | | ----------- | ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | 400 | `INVALID_IDENTIFIER_VALUE` | The access request ID must be a valid uuid. | | 400 | `INVALID_VALUE` | Invalid Parameter or Invalid operation. | | 400 | `BAD_REQUEST` | The access request ID is required but was not provided in the request. | | 400 | `MISSING_VALUE` | Missing header or parameter. For details, see the `diagnostics` field. | | 401 | `ACCESS_DENIED` | Missing or invalid OAuth 2.0 bearer token in request. | | 403 | `FORBIDDEN` | Access denied to resource. | | 404 | `QUESTIONNAIRE_RESPONSE_NOT_FOUND` | No questionnaire response was found for the provided access request ID. | | 405 | `METHOD_NOT_ALLOWED` | The method is not allowed. | | 408 | `TIMEOUT` | Request timed out. | | 429 | `THROTTLED` | You have exceeded your application's [rate limit](https://digital.nhs.uk/developer/guides-and-documentation/reference-guide#rate-limits). |
- `5XX` — Errors will be returned for the first error encountered in the request. An error occurred as follows: | HTTP status | Error code | Description | | ----------- | -------------------------- | ------------------------------------------------------------ | | 500 | `SERVER_ERROR` | An unexpected internal server error has occurred. | | 501 | `NOT_IMPLEMENTED` | API Endpoint not implemented. | | 502 | `BAD_GATEWAY` | Connection to the backend service failed. | | 503 | `DOWNSTREAM_SERVICE_ERROR` | Failed to generate response |

## Changes

- **2026-03-06** `aeaecd373dba` — 2 breaking, 46 info
  - the `issue/items/expression` response's property type/format changed from `string`/`` to `array`/`` for status `4XX`
  - the `issue/items/expression` response's property type/format changed from `string`/`` to `array`/`` for status `5XX`
  - removed the `business-rule` enum value from the `issue/items/code` response property for the response status `4XX`
  - removed the `business-rule` enum value from the `issue/items/code` response property for the response status `5XX`
  - …44 more
- **2025-10-15** `7d1c5609b6db` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/nhs/apis/validated-relationships-service-api-2/changes/QuestionnaireResponse/:id/get.md)

---

[API](https://skmtc.dev/nhs/apis/validated-relationships-service-api-2.md) · [All operations](https://skmtc.dev/nhs/apis/validated-relationships-service-api-2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nhs/validated-relationships-service-api-2/revisions/f212e0c81005/schema)