# Lazareus Object Retrieval

> Lazareus Object Retrieval is a paid API for AI agents from lazareus.xyz, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-16).

Retrieves a previously stored object by its key and streams it back with its original Content-Type header preserved.

## Facts

- Endpoint: GET https://lazareus.xyz/retrieve
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/lazareus-object-retrieval-8d4c99b9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_yLzLVkeH-ddFLOS7SM13o

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 lazareus-object-retrieval-8d4c99b9
```

Example prompt: Fetch the object I stored earlier with the key 'report-2024-q4.pdf' from Lazareus and give me its contents.

## When to prefer this

Use this endpoint when you need to retrieve a specific object by its exact key from Lazareus storage, particularly in pay-per-call agent workflows where you stored the object via Lazareus's companion store endpoint. Prefer this over generic S3 or cloud storage SDKs when operating in an x402 micropayment context where per-call billing ($0.01 USDC) is acceptable and no long-term credentials need to be managed.

## Known failure modes

- Key not found — returns 404 if the provided key does not match any stored object
- Missing key parameter — returns an error if the ?key= query param is absent or empty
- Expired or deleted object — returns 404 if the object was deleted or TTL-expired
- Payment failure — x402 payment challenge returned if USDC payment is not provided or invalid
- Network timeout — large objects may time out if the connection is dropped mid-stream

## How this service works

Lazareus gives AI agents pay-per-call S3-compatible storage, plus real-time network health scores and priority fee recommendations across Solana, Base, and Ethereum. No account, no subscription — paid per call via x402.

## Output

The raw binary or text content of the stored object, streamed back with its original Content-Type header (e.g. application/json, image/png, text/plain). The response body is the object itself, not a wrapper or metadata envelope.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lazareus-object-retrieval-8d4c99b9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lazareus.xyz](https://www.zero.xyz/host/lazareus.xyz/llms.txt)