# Kiln Memory – Read Document

> Kiln Memory – Read Document is a paid API for AI agents from memory.fluidrack.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-15).

Retrieves a stored JSON document from a durable TTL namespace by key

## Facts

- Endpoint: GET https://memory.fluidrack.com/v1/ns/:ns/docs/:key
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/kiln-memory-read-document-fec8da1d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cHWrA6ZH6SBgYbYa43_gS

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 kiln-memory-read-document-fec8da1d
```

Example prompt: Can you fetch the document stored under the key 'session-context-42' in the 'agent-workspace' namespace from Kiln Memory?

## When to prefer this

Use this endpoint when an AI agent needs to read back a specific JSON document it (or another agent) previously persisted in Kiln Memory by namespace and key. Prefer this over generic key-value stores when you are already using Kiln Memory's TTL namespace model for agent state, checkpointing, or inter-agent communication, and need a pay-per-read micropayment-compatible retrieval mechanism.

## Known failure modes

- Key not found – document was never written or has been deleted
- TTL expired – document existed but its namespace TTL has elapsed
- Namespace not found – the specified ns does not exist
- Payment failure – x402 micropayment of $0.01 USDC not processed, request rejected
- Invalid parameters – ns or key missing from query params
- Rate limiting or service unavailability

## How this service works

Read document

## Output

Returns the JSON document stored at the specified namespace and key. If the document exists and has not expired, the response includes the full JSON payload previously written. If the key does not exist or the TTL has elapsed, an appropriate error or empty response is returned.

## 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "pathParams": {
     "type": "object"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "ns",
      "key"
     ],
     "properties": {
      "ns": {
       "type": "string"
      },
      "key": {
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/kiln-memory-read-document-fec8da1d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from memory.fluidrack.com](https://www.zero.xyz/host/memory.fluidrack.com/llms.txt)