---
title: "List containers"
method: GET
path: "/containers"
---

# List containers

`GET /containers`

Returns a list of all the active container repositories in your account

## Query parameters

- `page` integer
- `per_page` integer
- `filter_name` string
- `filter_tag` string
- `filter_team_id` integer
- `filter_status` 'all' | 'active' | 'inactive'
- `filter_reachability` 'unknown' | 'direct' | 'lb' | 'limited_ips' | 'none'
- `include_is_running` boolean
- `include_sensitivity` boolean
- `include_connectivity` boolean
- `include_labels` boolean

## Response `200`

A list of container repositories

- object
  - `id` integer, required — The repository's id in Aikido.
  - `name` string, required — The name of the code repository.
  - `provider` 'aws' | 'gcp-artifact-registry' | 'gcp-container-registry' | 'aws' | 'docker-hub' | 'github' | 'quay' | 'acr' | 'gitlab' | 'gitlab-self' | 'digitalocean' | 'scaleway' | 'cloudsmith' | 'harbor' | 'artifactory' | 'custom_upload' | 'oci' | 'kubernetes', required — The provider place where the code repository is hosted
  - `cloud_id` integer, nullable, required — The ID of the cloud that acts as the registry where this container is located in.
  - `registry_id` integer, nullable, required — The ID of the registry where this container is located in.
  - `registry_name` string, nullable, required — The name of the container registry.
  - `tag` string, required — The tag filter used when selecting an image. If empty the latest image will be scanned.
  - `distro` string — The distribution of the image's OS.
  - `distro_version` string — The distribution version of the image's OS.
  - `last_scanned_at` integer — Timestamp representing the last time a scan for this container ended. Value is -1 when no scan happened yet.
  - `last_scanned_tag` string — The container image tag that was used in the latest scan.
  - `linked_code_repo_id` string — The id of the code repo to which this container is linked. Value is 'null' when no code repo is linked.
  - `last_pushed_at` integer — Timestamp representing the last a digest was pushed to this container. Value is -1 when this is unknown.
  - `created_at` integer — Timestamp representing when the container was created in Aikido.
  - `is_active` boolean — Whether the container is being scanned by Aikido.
  - `is_empty` boolean — Whether the container repository has no image pushed to it.
  - `is_running` boolean — Whether the container is currently running anywhere.
  - `exposed_via` 'unknown' | 'direct' | 'lb' | 'limited_ips' | 'none' — How the running container image is reachable from the internet. Values direct, lb, and limited_ips indicate the image is reachable; none indicates it is not reachable; unknown indicates reachability could not be determined.
  - `connectivity` 'connected' | 'not_connected' | 'unknown' — Tells Aikido if this code runs in an internet-connected server
  - `sensitivity` 'extreme' | 'sensitive' | 'normal' | 'not_sensitive' | 'no_data' — The sensitivity of the repository.
  - `labels` object[] — The labels of the repository.
    - `id` integer — The id of the label.
    - `name` string — The name of the label.
    - `is_imported` boolean — Whether the label was imported from a third party.

---

[API](https://skmtc.net/aikido/apis/authorization.md) · [All operations](https://skmtc.net/aikido/apis/authorization/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aikido/authorization/versions/5445e7c21137/schema)