---
title: "Get the container specification(s) for the specified image."
method: GET
path: "/tools/{id}/versions/{version_id}/containerfile"
tags: ["GA4GH"]
---

# Get the container specification(s) for the specified image.

`GET /tools/{id}/versions/{version_id}/containerfile`

Returns the container specifications(s) for the specified image. For example, a CWL CommandlineTool can be associated with one specification for a container, a CWL Workflow can be associated with multiple specifications for containers.

## Path parameters

- `id` string, required
- `version_id` string, required

## Response `200`

The tool payload.

- FileWrapper[]
  - `content` string — The content of the file itself. One of url or content is required.
  - `checksum` Checksum[] — A production (immutable) tool version is required to have a hashcode. Not required otherwise, but might be useful to detect changes.
    - `checksum` string, required — The hex-string encoded checksum for the data.
    - `type` string, required — The digest method used to create the checksum. The value (e.g. `sha-256`) SHOULD be listed as `Hash Name String` in the https://github.com/ga4gh-discovery/ga4gh-checksum/blob/master/hash-alg.csv[GA4GH Checksum Hash Algorithm Registry]. Other values MAY be used, as long as implementors are aware of the issues discussed in https://tools.ietf.org/html/rfc6920#section-9.4[RFC6920]. GA4GH may provide more explicit guidance for use of non-IANA-registered algorithms in the future.
  - `image_type` union — Optionally return additional information on the type of file this is
    - 'Docker' | 'Singularity' | 'Conda' — Indicates what kind of container is this image is.
    - 'CWL' | 'WDL' | 'NFL' | 'GALAXY' | 'SMK' — The type of descriptor that represents this version of the tool. Note that these files can also include associated Docker/container files and test parameters that further describe a version of a tool.
  - `url` string — Optional url to the underlying content, should include version information, and can include a git hash. Note that this URL should resolve to the raw unwrapped content that would otherwise be available in content. One of url or content is required.

## Other responses

- `404` — There are no container specifications for this tool.

## Changes

- **2022-03-17** `71edd3929128` — 1 info
  - added the optional property `items/image_type` to the response with the `200` status
- **2020-12-23** `a7ee6347c3cd` — 2 breaking
  - removed the media type `text/plain` for the response with the status `200`
  - removed the media type `text/plain` for the response with the status `404`
- **2019-08-14** `eab37df28ccf` — 2 info
  - added the optional property `items/checksum` to the response with the `200` status (media type: application/json)
  - added the optional property `items/checksum` to the response with the `200` status (media type: text/plain)
- **2019-08-13** `5ee7d3a548a8` — 1 info
  - the endpoint scheme security `BEARER` was added to the API
- **2019-06-12** `00ccac2487d2` — 2 warning, 3 info
  - removed the optional property `items/checksum` from the response with the `200` status
  - removed the optional property `items/image_type` from the response with the `200` status
  - the endpoint scheme security `BEARER` was removed from the API
  - added the media type `text/plain` for the response with the status `200`
  - …1 more

[Change history](https://skmtc.dev/ga4gh/apis/ga4gh-tool-discovery-api/changes/tools/:id/versions/:version_id/containerfile/get.md)

---

[API](https://skmtc.dev/ga4gh/apis/ga4gh-tool-discovery-api.md) · [All operations](https://skmtc.dev/ga4gh/apis/ga4gh-tool-discovery-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ga4gh/ga4gh-tool-discovery-api/revisions/adbe60a993bf/schema)