GET

/things/{thingName}/jobs

http://iot.{region}.amazonaws.com/things/{thingName}/jobs

Lists the job executions for the specified thing. Requires permission to access the <a href="https://docs.aws.amazon.com/service-authorization/latest/reference/list_awsiot.html#awsiot-actions-as-permissions">ListJobExecutionsForThing</a> action.

Access Token Required: API Key

Path Parameters

thingNamestringrequired

The thing name.

Query Params

statusstring

An optional filter that lets you search for jobs that have the specified status.

Allowed:

namespaceIdstring

The namespace used to indicate that a job is a customer-managed job. When you specify a value for this parameter, Amazon Web Services IoT Core sends jobs notifications to MQTT topics that contain the value in the following format. <code>$aws/things/THING_NAME/jobs/JOB_ID/notify-namespace-NAMESPACE_ID/</code> <note> The <code>namespaceId</code> feature is in public preview. </note>

maxResultsinteger

The maximum number of results to be returned per request.

nextTokenstring

The token to retrieve the next set of results.

jobIdstring

The unique identifier you assigned to this job when it was created.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://iot.{region}.amazonaws.com/things/{thingName}/jobs' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}