Skip to main content
GET
/
v1
/
evidence
List pieces of evidence
curl --request GET \
  --url https://api.app.chainloop.dev/v1/evidence \
  --header 'Authorization: Bearer <token>'
{
  "pagination": {
    "next_cursor": "next_cursor"
  },
  "results": [
    {
      "workflow_id": "workflow_id",
      "workflow_name": "workflow_name",
      "uploaded_to_cas": true,
      "kind": "kind",
      "latest_in_project_version": true,
      "subject_version": "subject_version",
      "annotations": {
        "key": "annotations"
      },
      "created_at": "2000-01-23T04:56:07.000Z",
      "organization_name": "organization_name",
      "project_version_id": "project_version_id",
      "project_name": "project_name",
      "latest_in_project": true,
      "project_version_name": "project_version_name",
      "project_id": "project_id",
      "organization_id": "organization_id",
      "name": "name",
      "digest": "digest",
      "subject_name": "subject_name",
      "id": "id",
      "workflow_run_id": "workflow_run_id"
    },
    {
      "workflow_id": "workflow_id",
      "workflow_name": "workflow_name",
      "uploaded_to_cas": true,
      "kind": "kind",
      "latest_in_project_version": true,
      "subject_version": "subject_version",
      "annotations": {
        "key": "annotations"
      },
      "created_at": "2000-01-23T04:56:07.000Z",
      "organization_name": "organization_name",
      "project_version_id": "project_version_id",
      "project_name": "project_name",
      "latest_in_project": true,
      "project_version_name": "project_version_name",
      "project_id": "project_id",
      "organization_id": "organization_id",
      "name": "name",
      "digest": "digest",
      "subject_name": "subject_name",
      "id": "id",
      "workflow_run_id": "workflow_run_id"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer token for authentication

Query Parameters

​
project_name
string

ProjectName is the name of the project to filter by

​
project_version_name
string

ProjectVersionName is the name of the project version to filter by

​
kind
enum<string>[]

Kind is the type of evidence to filter by

The type of evidence to filter by

​
pagination.cursor
string

The cursor to start pagination from

The cursor to start pagination from

​
pagination.limit
integer
default:10

The limit of the number of entries to return

The maximum number of entries to return

​
latest
boolean

If true, only the latest evidence for each kind and name is returned

​
workflow_name
string[]

WorkflowName is the list of workflow names to filter by

List of workflow names to filter by (DNS-1123 format)

​
search
string

Search provides a way to search evidence by name or subject name

Search term to filter evidence by name or subject name

​
hide_attestation
boolean

HideAttestation excludes attestation evidence from results when set to true

If true, excludes attestation evidence from the results

​
product_id
string

ProductID is the ID of the product to filter by

ID of the product to filter evidence by

​
product_version_id
string

ProductVersionID is the ID of the product version to filter by

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

Response

A successful response.

Response for the List method

​
results
EvidenceListItem · object[]
​
pagination
object

Pagination information for cursor-based pagination

Example:
{ "next_cursor": "next_cursor" }