---
title: "GET /human-loops/{HumanLoopName}"
method: GET
path: "/human-loops/{HumanLoopName}"
---

# GET /human-loops/{HumanLoopName}

`GET /human-loops/{HumanLoopName}`

Returns information about the specified human loop. If the human loop was deleted, this operation will return a <code>ResourceNotFoundException</code> error.

## Path parameters

- `HumanLoopName` string, required

## Response `200`

Success

- DescribeHumanLoopResponse
  - `CreationTime` string, date-time, required — The creation time when Amazon Augmented AI created the human loop.
  - `FailureReason` string — The reason why a human loop failed. The failure reason is returned when the status of the human loop is <code>Failed</code>.
  - `FailureCode` string — <p>A failure code that identifies the type of failure.</p> <p>Possible values: <code>ValidationError</code>, <code>Expired</code>, <code>InternalError</code> </p>
  - `HumanLoopStatus` 'InProgress' | 'Failed' | 'Completed' | 'Stopped' | 'Stopping', required — The status of the human loop.
  - `HumanLoopName` string, required — The name of the human loop. The name must be lowercase, unique within the Region in your account, and can have up to 63 characters. Valid characters: a-z, 0-9, and - (hyphen).
  - `HumanLoopArn` string, required — The Amazon Resource Name (ARN) of the human loop.
  - `FlowDefinitionArn` string, required — The Amazon Resource Name (ARN) of the flow definition.
  - `HumanLoopOutput` object — An object that contains information about the output of the human loop.
    - `OutputS3Uri` string, required — The location of the Amazon S3 object where Amazon Augmented AI stores your human loop output.

## Other responses

- `480` — ValidationException
- `481` — ResourceNotFoundException
- `482` — ThrottlingException
- `483` — InternalServerException

---

[API](https://skmtc.net/aws/apis/sagemaker-a2i-runtime.md) · [All operations](https://skmtc.net/aws/apis/sagemaker-a2i-runtime/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/sagemaker-a2i-runtime/versions/2c5b0408d20c/schema)