---
title: "List AWS Batch job definitions visible to this EDH environment"
method: GET
path: "/api/containers/batch/job_definition"
tags: ["AWS Batch"]
---

# List AWS Batch job definitions visible to this EDH environment

`GET /api/containers/batch/job_definition`

Retrieves AWS Batch job definitions that are tagged with the EDH visibility tag for this cluster.
If a specific job definition name is provided, only that definition is returned (if it has the correct tag).
Otherwise, all matching definitions are returned with pagination handled automatically.

## Query parameters

- `job_definition` string
- `status` 'ACTIVE' | 'INACTIVE'

## Headers

- `X-EDH-USER` string, required
- `X-EDH-TOKEN` string, required

## Response `200`

Job definitions retrieved successfully

- object
  - `success` boolean, required
  - `message` object[], required
    - `jobDefinitionName` string
    - `jobDefinitionArn` string
    - `revision` integer
    - `status` string
    - `type` string
    - `containerProperties` object
    - `tags` object

## Other responses

- `400` — Bad request - feature disabled or invalid parameters
- `401` — Unauthorized - invalid authentication
- `403` — Forbidden - IAM permission error
- `500` — Internal server error

## Changes

> 6 revisions in range; 3 could not be searched.

- **2026-04-21** (v1) `6db97cead8df` — 1 info
  - endpoint added
- **2025-08-05** (v1) `55c07c16d2e1` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/aws-samples/apis/engineering-development-hub-edh-api/changes/api/containers/batch/job_definition/get.md)

---

[API](https://skmtc.dev/aws-samples/apis/engineering-development-hub-edh-api.md) · [All operations](https://skmtc.dev/aws-samples/apis/engineering-development-hub-edh-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/aws-samples/engineering-development-hub-edh-api/revisions/058396b8f0f1/schema)