# List artifacts

Lists all the artifacts

Endpoint: GET /har/api/v1/spaces/{space_ref}/artifacts
Version: 1.0
Security: x-api-key

## Path parameters:

  - `space_ref` (string, required)
    Reference to the scope in which the registry exists.

Format depends on the scope:

- Account-level: account_id/+
- Organization-level: account_id/org/+
- Project-level: account_id/org/project/+

The /+ suffix is used internally to route scoped requests.
It must be included exactly as shown in the URL.

## Query parameters:

  - `reg_identifier` (array)
    Registry Identifier

  - `page` (integer)
    Current page number

  - `size` (integer)
    Number of items per page

  - `sort_order` (string)
    sortOrder

  - `sort_field` (string)
    sortField

  - `search_term` (string)
    search Term.

  - `latest_version` (boolean)
    Latest Version Filter.

  - `deployed_artifact` (boolean)
    Deployed Artifact Filter.

  - `package_type` (array)
    Registry Package Type

## Response 200 fields (application/json):

  - `data` (object, required)
    A list of Artifacts

  - `data.artifacts` (array, required)
    A list of Artifact

  - `data.artifacts.artifactType` (string)
    refers to artifact type
    Enum: "model", "dataset"

  - `data.artifacts.deletedAt` (string)
    Timestamp in milliseconds when the artifact was soft deleted. Null if not deleted.

  - `data.artifacts.deploymentMetadata` (object)

  - `data.artifacts.deploymentMetadata.nonProdEnvCount` (integer, required)

  - `data.artifacts.deploymentMetadata.prodEnvCount` (integer, required)

  - `data.artifacts.digestCount` (integer)

  - `data.artifacts.downloadsCount` (integer)

  - `data.artifacts.fileCount` (integer)

  - `data.artifacts.firewallMode` (string)
    Enum: "ENABLED", "QUARANTINE", "ALLOW"

  - `data.artifacts.isQuarantined` (boolean)

  - `data.artifacts.labels` (array)

  - `data.artifacts.lastModified` (string)

  - `data.artifacts.lastScannedAt` (string)

  - `data.artifacts.latestVersion` (string, required)

  - `data.artifacts.metadata` (object)
    Artifact Entity Metadata

  - `data.artifacts.name` (string, required)

  - `data.artifacts.packageType` (string, required)
    refers to package
    Enum: "DOCKER", "MAVEN", "PYTHON", "GENERIC", "HELM", "NUGET", "NPM", "RPM", "CARGO", "COMPOSER", "GO", "HUGGINGFACE", "CONDA", "DART", "SWIFT", "PUPPET", "RAW"

  - `data.artifacts.pullCommand` (string)

  - `data.artifacts.purl` (string)
    Package URL (PURL) identifying the package version.

  - `data.artifacts.quarantineReason` (string)

  - `data.artifacts.registryIdentifier` (string, required)

  - `data.artifacts.registryPath` (string, required)

  - `data.artifacts.registryType` (string)
    refers to type of registry i.e virtual or upstream
    Enum: "VIRTUAL", "UPSTREAM"

  - `data.artifacts.registryUUID` (string, required)

  - `data.artifacts.scanId` (string)

  - `data.artifacts.scanStatus` (string)
    Enum: "WARN", "BLOCKED", "ALLOWED"

  - `data.artifacts.uuid` (string, required)

  - `data.artifacts.version` (string, required)

  - `data.itemCount` (integer)
    The total number of items
    Example: 1

  - `data.pageCount` (integer)
    The total number of pages
    Example: 100

  - `data.pageIndex` (integer)
    The current page

  - `data.pageSize` (integer)
    The number of items per page
    Example: 1

  - `status` (string, required)
    Request processing status indicator
    Enum: "SUCCESS", "FAILURE", "ERROR"

## Response 400 fields (application/json):

  - `code` (string, required)
    The HTTP error code
    Example: "404"

  - `details` (object)
    Additional context and details about the error.
May include field-specific validation errors or debugging information.
    Example: {"field":"registry_identifier","reason":"Registry does not exist in the specified project","value":"invalid-registry"}

  - `message` (string, required)
    Human-readable error message explaining what went wrong
    Example: "Registry not found"