---
title: "GET /v1/tasks"
method: GET
path: "/v1/tasks"
tags: ["[v1] Innovation Tasks"]
---

# GET /v1/tasks

`GET /v1/tasks`

## 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/tasks`
- Auth: none declared

Get a list of innovation tasks.

## Query parameters

- `skip` integer
- `take` integer
- `order` object
- `innovationId` string, uuid
- `innovationName` string, nullable
- `sections` string[]
- `status` string[]
- `innovationStatus` string[]
- `createdByMe` boolean
- `createdByMyUnit` boolean
- `fields` string[]

## Response `200`

The list of innovation tasks.

- object
  - `count` integer, required
  - `data` object
    - `id` string, uuid, required
    - `displayId` string, required
    - `innovation` object, required
      - `id` string, uuid, required
      - `name` string, required
    - `status` 'OPEN' | 'DONE' | 'DECLINED' | 'CANCELLED', required
    - `section` 'INNOVATION_DESCRIPTION' | 'UNDERSTANDING_OF_NEEDS' | 'EVIDENCE_OF_EFFECTIVENESS' | 'MARKET_RESEARCH' | 'CURRENT_CARE_PATHWAY' | 'TESTING_WITH_USERS' | 'REGULATIONS_AND_STANDARDS' | 'INTELLECTUAL_PROPERTY' | 'REVENUE_MODEL' | 'COST_OF_INNOVATION' | 'DEPLOYMENT', required
    - `sameOrganisation` boolean, required
    - `notifications` integer, required
    - `createdAt` string, date-time, required
    - `createdBy` object, required
      - `name` string, required
      - `displayTag` string, required
    - `updatedAt` string, date-time, required
    - `updatedBy` object, required
      - `name` string, required
      - `displayTag` string, required

## Other responses

- `400`: The request is invalid.
- `401`: The user is not authenticated.
- `403`: The user is not authorized to access this resource.
- `500`: An error occurred while processing the request.

## Changes

- **2025-01-10** `063b02827491`: 1 breaking
  - for the `query` request parameter `createdByMyUnit`, default value `true` was added
- **2024-12-19** `706ccc30c289`: 1 warning
  - deleted the `query` request parameter `allTasks`
- **2024-12-19** `d4f50a2f1fd8`: 1 info
  - added the new optional `query` request parameter `createdByMyUnit`
- **2024-11-07** `761f95f46b23`: 5 breaking, 1 warning, 18 info
  - for the `query` request parameter `order`, default value `{"default":"DESC"}` was added
  - for the `query` request parameter `take`, default value `20` was added
  - for the `query` request parameter `innovationId`, the format changed from no format to `uuid`
  - for the `query` request parameter `order`, the type changed from `string` to `object`
  - …20 more

[Operation history](https://skmtc.dev/nhs-england/apis/innovations-api-nhs-innovation-service/changes/v1/tasks/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)