---
title: "New Access request"
method: POST
path: "/QuestionnaireResponse"
---

# New Access request

`POST /QuestionnaireResponse`

## Overview
For any new access request, the necessary details should be collected from a user facing service e.g.
Proxy Access Service and submitted as a QuestionnaireResponse.

## Access modes

This endpoint supports the following access modes:

- Patient access

## Sandbox test scenarios:

You can test the following scenarios in our sandbox environment:

| Scenario               | Request                                                                                     | Response                                       |
| ---------------------- | ------------------------------------------------------------------------------------------- | -----------------------------------------------|
| Successful request     | Valid request with performer identifier value of `9000000009` or `9000000017`               | HTTP Status 200 Success response               |
| Duplicate proxy role   | Request for proxy role that already exists, with performer identifier value of `9000000049` | HTTP Status 409 and DUPLICATE error response   |


### Sandbox constraints

The sandbox environment has the following constraints for this endpoint:

- QuestionnaireResponse is not validated.
- Request headers are not tested. `X-Request-ID` and `X-Correlation-ID` are disregarded.
- No access request is created.

## Headers

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

## Response `200`

Request was received successfully for processing

## 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 | `MISSING_VALUE` | Missing header or parameter. For details, see the `diagnostics` field. | | 400 | `INVALID_VALUE` | Invalid Parameter or Invalid operation. | | 400 | `BAD_REQUEST` | Failed questionnaire response validation | | 401 | `ACCESS_DENIED` | Missing or invalid OAuth 2.0 bearer token in request. | | 403 | `FORBIDDEN` | Access denied to resource. | | 405 | `METHOD_NOT_ALLOWED` | The method is not allowed. | | 408 | `TIMEOUT` | Request timed out. | | 409 | `DUPLICATE_RELATIONSHIP` | A proposed proxy role already exists for this proxy/patient relationship. | | 415 | `UNSUPPORTED_MEDIA` | Unsupported media type. | | 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. | | 502 | `BAD_GATEWAY` | Connection to the backend service failed. |

## Changes

- **2026-03-06** `aeaecd373dba` — 3 breaking, 69 info
  - the `issue/items/expression` response's property type/format changed from `string`/`` to `array`/`` for status `200`
  - 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 `200`
  - …68 more

[Change history](https://skmtc.dev/nhs/apis/validated-relationships-service-api-2/changes/QuestionnaireResponse/post.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)