---
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.

---

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