# Artefaktum Get Artifact by ID

> Artefaktum Get Artifact by ID 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).

Retrieve metadata for a single artifact by its ID, including title, description, tags, custom metadata, status, expiry, and latest version info.

## Facts

- Endpoint: GET https://api.artefaktum.dev/v1/artifacts/search?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-get-artifact-by-id-d16ee021
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Vw74F3m4UXuL_E6dqHTUi

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-get-artifact-by-id-d16ee021
```

Example prompt: Pull up the metadata for artifact ID 'art_abc123' on Artefaktum — I want to see its title, description, tags, current status, and when it expires.

## When to prefer this

Use this endpoint when you have a specific artifact_id and need its full metadata snapshot (title, description, tags, status, expiry, latest version) without downloading the actual file bytes. Prefer this over listing endpoints when you already know the ID, and over the download URL endpoint when you only need metadata rather than file content. Use the external_key lookup sibling if you stored the artifact under your own custom name.

## Known failure modes

- Artifact ID not found — 404 response if the artifact_id does not exist or belongs to a different wallet
- Payment failure — x402 payment of $0.005 USDC not processed correctly
- Expired artifact — artifact exists but status indicates it has expired
- Malformed artifact_id — invalid format causes 400 bad request
- Wallet mismatch — artifact belongs to a project not accessible by the paying wallet

## How this service works

Search the artifacts in one of the wallet's projects by meaning and by text (mode hybrid, semantic, text or exact), with filters on content type, tags, status and dates. Body: project_id, query. Returns {items: [{artifact, score, match_mode}], next_cursor, mode}. Costs $0.01 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

Returns a JSON object containing the artifact's title, description, tags, custom metadata fields, current status (e.g. active/expired), expiry timestamp, and information about the latest version of the artifact's content.

## 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": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/artefaktum-get-artifact-by-id-d16ee021/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)