---
title: "Create advice and guidance request (A044, FHIR STU3)"
method: POST
path: "/STU3/CommunicationRequest/$ers.createAdviceAndGuidance"
tags: ["Request advice"]
---

# Create advice and guidance request (A044, FHIR STU3)

`POST /STU3/CommunicationRequest/$ers.createAdviceAndGuidance`

## Overview

Use this endpoint to create an advice and guidance request from a referring organisation to a service providing organisation.

An advice and guidance request includes important contextual information. For example, the service and specialty to which advice has been requested. Creating the request also starts the conversation between a referrer seeking advice and a provider from whom the advice is sought.

Conversation messages can include attachments.

## Supported security patterns

Healthcare worker, user-restricted access

## Important notes

The maximum number of services allowed on a given shortlist is 1.

In order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. 
The availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code. 

Further details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A024]], [[HYPERLINK_A025]] and [[HYPERLINK_A042]] specifications.

## Pre-requisites
To use this endpoint, you must be an authenticated e-RS user and use one of the following e-RS roles:
  - `REFERRING_CLINICIAN`
  - `REFERRING_CLINICIAN_ADMIN`

You need to have identified a patient, for example via [[HYPERLINK_PDS]].

You need to have found services that meet the referral needs of a patient using [[HYPERLINK_A010]].

If you want to include attachments with the request, you need to use [[HYPERLINK_A020]] so they are ready to be associated with the request.

## Use case

As an authenticated user 

I need to request some advice from a given service

So I can either initiate my patient's referral pathway or provide recommended treatment.

## Related endpoints

Providers are able to respond to an advice and guidance request via [[HYPERLINK_A026]] or convert the advice and guidance request into a referral via [[HYPERLINK_A027]].

Referrers and providers can use:

[[HYPERLINK_A024]] to retrieve the summary of an advice and guidance request

[[HYPERLINK_A025]] to retrieve the advice and guidance conversation.

## Parameters

- `#/paths/~1STU3~1Task/get/parameters/0` — unresolved $ref
- `#/paths/~1STU3~1Task/get/parameters/1` — unresolved $ref
- `#/paths/~1STU3~1Slot/get/parameters/2` — unresolved $ref
- `#/paths/~1STU3~1Task/get/parameters/4` — unresolved $ref

## Response `200`

An Advice And Guidance Request created within e-RS.

## Other responses

- `400` — unresolved $ref
- `401` — unresolved $ref
- `403` — unresolved $ref
- `406` — unresolved $ref
- `415` — unresolved $ref
- `422` — unresolved $ref
- `429` — unresolved $ref
- `500` — unresolved $ref
- `503` — unresolved $ref

---

[API](https://skmtc.dev/nhs/apis/e-referrals-service-api.md) · [All operations](https://skmtc.dev/nhs/apis/e-referrals-service-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nhs/apis/e-referrals-service-api/revisions/916969ea472f?raw)