---
title: "GET /v1/{innovationId}/threads/available-recipients"
method: GET
path: "/v1/{innovationId}/threads/available-recipients"
tags: ["[v1] Innovation Threads Available Recipients"]
---

# GET /v1/{innovationId}/threads/available-recipients

`GET /v1/{innovationId}/threads/available-recipients`

## Request

- Base URL: `https://nhse-${ENV}-innovation-service-innovation-functions.azurewebsites.net/api`
- URL: `https://nhse-${ENV}-innovation-service-innovation-functions.azurewebsites.net/api/v1/{innovationId}/threads/available-recipients`
- Auth: none declared

Get a list with a list of thread recipients for a respective innovation.

## Path parameters

- `innovationId` string, uuid, required

## Response `200`

Success

- object[]
  - `id` string, uuid, required
  - `status` 'ENGAGING' | 'WAITING' | 'SUGGESTED' | 'PREVIOUS_ENGAGED'
  - `organisation` object, required
    - `id` string, uuid, required
    - `name` string, required
    - `acronym` string, required
    - `unit` object
      - `id` string, uuid, required
      - `name` string, required
      - `acronym` string, required
  - `recipients` object
    - `id` string, uuid, required
    - `name` string, required

## Other responses

- `404`: Not found

## Changes

- **2024-11-07** `761f95f46b23`: 1 breaking, 1 info
  - for the `path` request parameter `innovationId`, the format changed from no format to `uuid`
  - added the media type `application/json` for the response with the status `200`

[Operation history](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service/changes/v1/:innovationId/threads/available-recipients/get.md)

---

[API](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service.md) - [All operations](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service/revisions/c7535c8a7a65?raw)