---
title: "GET /model-invocation-job/{jobIdentifier}"
method: GET
path: "/model-invocation-job/{jobIdentifier}"
---

# GET /model-invocation-job/{jobIdentifier}

`GET /model-invocation-job/{jobIdentifier}`

Gets details about a batch inference job. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/batch-inference-monitor">Monitor batch inference jobs</a>

## Path parameters

- `jobIdentifier` string, required

## Response `200`

Success

- GetModelInvocationJobResponse
  - `jobArn` string, required — The Amazon Resource Name (ARN) of the batch inference job.
  - `jobName` string — The name of the batch inference job.
  - `modelId` string, required — The unique identifier of the foundation model used for model inference.
  - `clientRequestToken` string — A unique, case-sensitive identifier to ensure that the API request completes no more than one time. If this token matches a previous request, Amazon Bedrock ignores the request, but does not return an error. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">Ensuring idempotency</a>.
  - `roleArn` string, required — The Amazon Resource Name (ARN) of the service role with permissions to carry out and manage batch inference. You can use the console to create a default service role or follow the steps at <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/batch-iam-sr.html">Create a service role for batch inference</a>.
  - `status` 'Submitted' | 'InProgress' | 'Completed' | 'Failed' | 'Stopping' | 'Stopped' | 'PartiallyCompleted' | 'Expired' | 'Validating' | 'Scheduled' — <p>The status of the batch inference job.</p> <p>The following statuses are possible:</p> <ul> <li> <p>Submitted – This job has been submitted to a queue for validation.</p> </li> <li> <p>Validating – This job is being validated for the requirements described in <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/batch-inference-data.html">Format and upload your batch inference data</a>. The criteria include the following:</p> <ul> <li> <p>Your IAM service role has access to the Amazon S3 buckets containing your files.</p> </li> <li> <p>Your files are .jsonl files and each individual record is a JSON object in the correct format. Note that validation doesn't check if the <code>modelInput</code> value matches the request body for the model.</p> </li> <li> <p>Your files fulfill the requirements for file size and number of records. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/quotas.html">Quotas for Amazon Bedrock</a>.</p> </li> </ul> </li> <li> <p>Scheduled – This job has been validated and is now in a queue. The job will automatically start when it reaches its turn.</p> </li> <li> <p>Expired – This job timed out because it was scheduled but didn't begin before the set timeout duration. Submit a new job request.</p> </li> <li> <p>InProgress – This job has begun. You can start viewing the results in the output S3 location.</p> </li> <li> <p>Completed – This job has successfully completed. View the output files in the output S3 location.</p> </li> <li> <p>PartiallyCompleted – This job has partially completed. Not all of your records could be processed in time. View the output files in the output S3 location.</p> </li> <li> <p>Failed – This job has failed. Check the failure message for any further details. For further assistance, reach out to the <a href="https://console.aws.amazon.com/support/home/">Amazon Web Services Support Center</a>.</p> </li> <li> <p>Stopped – This job was stopped by a user.</p> </li> <li> <p>Stopping – This job is being stopped by a user.</p> </li> </ul>
  - `message` string, password — If the batch inference job failed, this field contains a message describing why the job failed.
  - `submitTime` string, date-time, required — The time at which the batch inference job was submitted.
  - `lastModifiedTime` string, date-time — The time at which the batch inference job was last modified.
  - `endTime` string, date-time — The time at which the batch inference job ended.
  - `inputDataConfig` object, required — Details about the location of the input to the batch inference job.
    - `s3InputDataConfig` object — Contains the configuration of the S3 location of the input data.
      - `s3InputFormat` 'JSONL' — The format of the input data.
      - `s3Uri` string, required — The S3 location of the input data.
      - `s3BucketOwner` string — The ID of the Amazon Web Services account that owns the S3 bucket containing the input data.
  - `outputDataConfig` object, required — Details about the location of the output of the batch inference job.
    - `s3OutputDataConfig` object — Contains the configuration of the S3 location of the output data.
      - `s3Uri` string, required — The S3 location of the output data.
      - `s3EncryptionKeyId` string — The unique identifier of the key that encrypts the S3 location of the output data.
      - `s3BucketOwner` string — The ID of the Amazon Web Services account that owns the S3 bucket containing the output data.
  - `vpcConfig` object — The configuration of the Virtual Private Cloud (VPC) for the data in the batch inference job. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/batch-vpc">Protect batch inference jobs using a VPC</a>.
    - `subnetIds` SubnetId[], required — An array of IDs for each subnet in the VPC to use.
    - `securityGroupIds` SecurityGroupId[], required — An array of IDs for each security group in the VPC to use.
  - `timeoutDurationInHours` integer — The number of hours after which batch inference job was set to time out.
  - `jobExpirationTime` string, date-time — The time at which the batch inference job times or timed out.
  - `modelInvocationType` 'InvokeModel' | 'Converse' — The invocation endpoint for ModelInvocationJob
  - `totalRecordCount` integer — The total number of records in the batch inference job.
  - `processedRecordCount` integer — The number of records that have been processed in the batch inference job.
  - `successRecordCount` integer — The number of records that were successfully processed in the batch inference job.
  - `errorRecordCount` integer — The number of records that failed to process in the batch inference job.

## Other responses

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

---

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