---
title: "GET /model-invocation-jobs"
method: GET
path: "/model-invocation-jobs"
---

# GET /model-invocation-jobs

`GET /model-invocation-jobs`

Lists all batch inference jobs in the account. For more information, see <a href="https://docs.aws.amazon.com/bedrock/latest/userguide/batch-inference-view.html">View details about a batch inference job</a>.

## Query parameters

- `submitTimeAfter` string, date-time
- `submitTimeBefore` string, date-time
- `statusEquals` 'Submitted' | 'InProgress' | 'Completed' | 'Failed' | 'Stopping' | 'Stopped' | 'PartiallyCompleted' | 'Expired' | 'Validating' | 'Scheduled'
- `nameContains` string
- `maxResults` integer
- `nextToken` string
- `sortBy` 'CreationTime'
- `sortOrder` 'Ascending' | 'Descending'

## Response `200`

Success

- ListModelInvocationJobsResponse
  - `nextToken` string — If there are more results than can fit in the response, a <code>nextToken</code> is returned. Use the <code>nextToken</code> in a request to return the next batch of results.
  - `invocationJobSummaries` ModelInvocationJobSummary[] — A list of items, each of which contains a summary about a batch inference job.
    - `jobArn` string, required — The Amazon Resource Name (ARN) of the batch inference job.
    - `jobName` string, required — 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 the 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` — AccessDeniedException
- `481` — ValidationException
- `482` — InternalServerException
- `483` — 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)