---
title: "GET /thing-registration-tasks/{taskId}"
method: GET
path: "/thing-registration-tasks/{taskId}"
---

# GET /thing-registration-tasks/{taskId}

`GET /thing-registration-tasks/{taskId}`

Describes a bulk thing provisioning task.

Requires permission to access the [DescribeThingRegistrationTask](https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions) action.

## Path parameters

- `taskId` string, required

## Response `200`

Success

- DescribeThingRegistrationTaskResponse
  - `taskId` string — The task ID.
  - `creationDate` string, date-time — The task creation date.
  - `lastModifiedDate` string, date-time — The date when the task was last modified.
  - `templateBody` string — The task's template.
  - `inputFileBucket` string — The S3 bucket that contains the input file.
  - `inputFileKey` string — The input file key.
  - `roleArn` string — The role ARN that grants access to the input file bucket.
  - `status` 'InProgress' | 'Completed' | 'Failed' | 'Cancelled' | 'Cancelling' — The status of the bulk thing provisioning task.
  - `message` string — The message.
  - `successCount` integer — The number of things successfully provisioned.
  - `failureCount` integer — The number of things that failed to be provisioned.
  - `percentageProgress` integer — The progress of the bulk provisioning task expressed as a percentage.

## Other responses

- `480` — InvalidRequestException
- `481` — ThrottlingException
- `482` — UnauthorizedException
- `483` — InternalFailureException
- `484` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/iot.md) · [All operations](https://skmtc.net/aws/apis/iot/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iot/revisions/deef5c4b09f0/schema)