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

# List containers

`GET /containers`

## Request

- Base URL: `https://app.aikido.dev/api/public/v1`
- URL: `https://app.aikido.dev/api/public/v1/containers`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `https://app.aikido.io/api/oauth/token` scopes: `repositories:read`

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.
  - `last_scanned_digest` string, nullable: The sha256 digest of the container image that was used in the latest scan. Value is 'null' when no scan happened yet.
  - `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.dev/aikido/apis/aikido-security-api-documentation.md) - [All operations](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/aikido/apis/aikido-security-api-documentation/revisions/da8691338133?raw)