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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.chainloop.dev/llms.txt

Use this file to discover all available pages before exploring further.

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)

  • CHAINLOOP_AI_AGENT_CONFIG: AI agent configuration collected automatically during attestation
  • UNKNOWN_KIND: Artifact kind is unknown — created from SBOM metadata when no matching attested artifact exists
  • CHAINLOOP_AI_CODING_SESSION: AI coding session evidence (e.g., Claude Code session traces)
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,
CHAINLOOP_AI_AGENT_CONFIG,
UNKNOWN_KIND,
CHAINLOOP_AI_CODING_SESSION
​
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

​
has_vulnerabilities
boolean

Filter by presence of actionable vulnerability findings, i.e. OPEN or IN_PROGRESS (true = has vulnerabilities, false = no vulnerabilities, unset = no filter). Findings resolved via assessment are excluded.

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" }