# Macaroon Network Polymathica Archive Record Retrieval

> Macaroon Network Polymathica Archive Record Retrieval is a paid API for AI agents from api.macaroonnetwork.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-09-15).

Retrieves a single sanitized archive metadata record from the Polymathica dataset by asset ID, including content hash, readiness state, field inventory summary, and evidence flags.

## Facts

- Endpoint: POST https://api.macaroonnetwork.com/execute/polymathica-archive-record-v1
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/macaroon-network-polymathica-archive-record-retrieval-2095c017
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cZQ9borv0XsI2Znl1XSNO

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 macaroon-network-polymathica-archive-record-retrieval-2095c017 -d '<json body>'
```

Example prompt: Pull up the full Polymathica archive metadata record for asset ID 'poly-7842x' — I need the content hash, readiness state, field inventory, and any evidence flags it has.

## When to prefer this

Use this endpoint when you need to inspect a specific, known archive record by its asset ID rather than searching across the corpus. It is the right choice when you already have an identifier and need authoritative metadata such as content hash, readiness state, field completeness, or evidence flags for a single Polymathica asset. Prefer the search sibling endpoint when you do not yet have an asset ID and need to discover records.

## Known failure modes

- Asset ID not found — returns an error or empty result if the provided ID does not match any record
- Invalid request body format — returns a validation error if required fields are missing or malformed
- Payment failure — x402 payment not completed, request rejected
- Record not yet sanitized or readiness state pending — returned record may indicate asset is not ready

## How this service works

Retrieve one sanitized archive metadata record by asset id, including content hash, readiness state, field inventory summary and evidence flags.

## Output

Returns a single sanitized archive metadata record containing: content hash (for integrity verification), readiness state (indicating whether the asset is available for use), a field inventory summary (listing which metadata fields are populated), and evidence flags (provenance or quality indicators). The record is derived from the Polymathica census archive.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object"
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "payload": {
   "record": {},
   "provenance": {}
  },
  "settled": true,
  "predicate_passed": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/macaroon-network-polymathica-archive-record-retrieval-2095c017/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.macaroonnetwork.com](https://www.zero.xyz/host/api.macaroonnetwork.com/llms.txt)
