Skip to main content
GET
/
v1
/
artifacts
List artifacts
curl --request GET \
  --url https://api.app.chainloop.dev/v1/artifacts \
  --header 'Authorization: Bearer <token>'
{
  "pagination": {
    "next_cursor": "next_cursor"
  },
  "results": [
    {
      "kind": "kind",
      "name": "name",
      "digest": "digest",
      "created_at": "2000-01-23T04:56:07.000Z",
      "id": "id",
      "version": "version"
    },
    {
      "kind": "kind",
      "name": "name",
      "digest": "digest",
      "created_at": "2000-01-23T04:56:07.000Z",
      "id": "id",
      "version": "version"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer token for authentication

Query Parameters

​
project_name
string

ProjectName is the name of the project to filter artifacts by

​
project_version_name
string

ProjectVersionName is the name of the project version to filter artifacts by

​
kind
enum<string>[]

Kind is the type of artifact to filter by

The type of artifact to filter by (e.g., CONTAINER_IMAGE, HELM_CHART)

Available options:
MATERIAL_TYPE_UNSPECIFIED,
STRING,
CONTAINER_IMAGE,
ARTIFACT,
SBOM_CYCLONEDX_JSON,
SBOM_SPDX_JSON,
JUNIT_XML,
OPENVEX,
HELM_CHART,
SARIF,
EVIDENCE,
ATTESTATION,
CSAF_VEX,
CSAF_INFORMATIONAL_ADVISORY,
CSAF_SECURITY_ADVISORY,
CSAF_SECURITY_INCIDENT_RESPONSE,
GITLAB_SECURITY_REPORT,
ZAP_DAST_ZIP,
BLACKDUCK_SCA_JSON,
TWISTCLI_SCAN_JSON,
GHAS_CODE_SCAN,
GHAS_SECRET_SCAN,
GHAS_DEPENDENCY_SCAN,
JACOCO_XML,
SLSA_PROVENANCE,
CHAINLOOP_RUNNER_CONTEXT,
CHAINLOOP_PR_INFO,
GITLEAKS_JSON
​
pagination.cursor
string

The cursor to start pagination from

The cursor to start pagination from

​
pagination.limit
integer<int32>
default:10

The limit of the number of entries to return

The maximum number of entries to return

​
search
string

Search provides a way to search artifacts by name, version, or digest

Search term to filter artifacts by name, version, or digest

​
product_id
string

ProductID is the ID of the product to filter artifacts by

ID of the product to filter artifacts by

​
product_version_id
string

ProductVersionID is the ID of the product version to filter artifacts by

ID of the product version to filter artifacts by. Must be provided with product_id

Response

A successful response.

Response for the List method

​
results
ArtifactItem · object[]
​
pagination
CursorPaginationResponse · object

Pagination information for cursor-based pagination

Example:
{ "next_cursor": "next_cursor" }