# Artefaktum List Artifact Versions

> Artefaktum List Artifact Versions is a paid API for AI agents from api.artefaktum.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-11-01).

Lists every version of a specific artifact, returning filename, content type, size, SHA-256 hash, and status for each version.

## Facts

- Endpoint: GET https://api.artefaktum.dev/v1/artifacts/:artifact_id/versions?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/artefaktum-list-artifact-versions-b6bfcbba
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dg8tR9vDwgWCC7_85aoqS

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability artefaktum-list-artifact-versions-b6bfcbba
```

Example prompt: Show me all the versions of artifact abc-789 on Artefaktum — I want to see each version's filename, size, sha256, and status.

## When to prefer this

Use this endpoint when you need a complete enumeration of all stored versions of a known artifact, including integrity checksums (sha256), file metadata, and status — rather than just the latest version info. Prefer this over the single-artifact GET endpoint when you need historical version data, audit trails, or want to compare versions. Choose this over the download URL endpoint when you need metadata rather than the file bytes themselves.

## Known failure modes

- artifact_id not found — returns 404 if the artifact does not exist or belongs to a different wallet
- wallet has insufficient USDC balance — payment fails and the call is rejected
- artifact has no versions yet — returns an empty array
- malformed artifact_id — returns 400 bad request
- network or payment processing timeout — transient failure, retry safe due to idempotent nature

## How this service works

List every version of an artifact: filename, content type, size, sha256 and status. Costs $0.005 in USDC. No signup: a wallet's first payment creates its account and a default project; the same wallet later reaches the same files.

## Output

An array of version objects for the specified artifact, each containing the version's filename, content type, file size in bytes, SHA-256 hash, and status (e.g. active, expired). Costs $0.005 USDC per call, charged automatically via the calling wallet.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "pathParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object",
     "required": [
      "artifact_id"
     ],
     "properties": {
      "artifact_id": {
       "type": "string"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "json"
    },
    "example": {
     "type": "array"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/artefaktum-list-artifact-versions-b6bfcbba/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.artefaktum.dev](https://www.zero.xyz/host/api.artefaktum.dev/llms.txt)