---
title: "Get Task Instruction by ID"
method: GET
path: "/v2/tasks/instructions/{instructionID}"
tags: ["Routes", "Tasks", "Instructions"]
---

# Get Task Instruction by ID

`GET /v2/tasks/instructions/{instructionID}`

This request retrieves a single Task Instruction by its instructionID.

**Path Parameters:**
- `instructionID` (required): The ID of the instruction to retrieve

**Return data description:**

Returns a single instruction object with the following properties:

| Property | Description |
|----------|-------------|
| instructionID | The unique identifier for this instruction |
| taskID | The ID of the task this instruction belongs to |
| parentInstructionID | This is the instructionID of the Instruction's parent. If this value is 0 then this Instruction does not have a parent. |
| instruction | The text that guides a User on what to do on this Instruction. |
| type | The type of the Instruction. See the request Post New Task Instruction to see a list of possible types and their meaning. |
| instructionFiles | Array of objects that have a file name and a link you can use to download that file. All links are only valid for 15 minutes, a new call will generate a new link. |
| response | This field is the 'response' of an instruction i.e. what a user filled out when completing this instruction. |

**Error Responses:**
- 404: Instruction not found

## Response `200`

Success Response

- object
  - `instructionID` integer
  - `taskID` integer
  - `parentInstructionID` integer
  - `instruction` string
  - `type` integer
  - `instructionFiles` object[]
    - `fileName` string
    - `downloadLink` string, uri
  - `response` string

## Other responses

- `400` — The request was malformed — either invalid JSON syntax or a validation failure (missing required field, wrong type, etc.).
- `401` — No `Authorization` header was provided on the request.
- `403` — The supplied credentials are invalid, the customer account is inactive, or the credentials do not have permission to perform this action.
- `404` — The referenced resource does not exist or is not visible to the authenticated customer.
- `429` — The per-minute or per-hour rate limit for this credential and method has been exhausted. Inspect the `X-RateLimit-*` headers to determine when to retry.
- `500` — An unhandled server-side error. The body message is generic (`System unavailable...`) when the underlying cause is a database fault; otherwise it reflects the raised error.

---

[API](https://skmtc.net/limblecmms/apis/limble-api-v2.md) · [All operations](https://skmtc.net/limblecmms/apis/limble-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/limblecmms/limble-api-v2/versions/20801e23f7f2/schema)