GET

/things/{thingName}/jobs/{jobId}

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

Gets details of a job execution.

Access Token Required: API Key

Path Parameters

jobIdstringrequired

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

thingNamestringrequired

The thing name associated with the device the job execution is running on.

Query Params

includeJobDocumentboolean

Optional. When set to true, the response contains the job document. The default is false.

executionNumberinteger

Optional. A number that identifies a particular job execution on a particular device. If not specified, the latest job execution is returned.

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://data.jobs.iot.{region}.amazonaws.com/things/{thingName}/jobs/{jobId}' \
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}

GET