# ISHOB Document Retrieval by ID

> ISHOB Document Retrieval by ID is a paid API for AI agents from api.ishob.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-14).

Fetches a licensed document (title, abstract, license, canonical ID) from the ISHOB full-text archive by its document ID.

## Facts

- Endpoint: GET https://api.ishob.com/api/document/%7Bid%7D?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ishob-document-retrieval-by-id-c156a009
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_IZsVFkqXJF9Q0U-aor8Lw

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 ishob-document-retrieval-by-id-c156a009
```

Example prompt: Pull the document with ID pmc-13364419 from the ISHOB archive and give me its title, abstract, and license.

## When to prefer this

Use this endpoint when you have a specific known document ID and need to retrieve its metadata (title, abstract, license) from the ISHOB licensed archive. Prefer this over the full-text search endpoint when you already know the canonical ID and want a direct lookup rather than a keyword-based search.

## Known failure modes

- Document ID not found returns a 404 or empty result
- Malformed or missing ID path parameter returns a 400 error
- Document exists but is not publicly licensed, resulting in restricted access
- Payment failure (x402) if USDC is not available or insufficient
- Rate limiting or timeout if archive is under heavy load

## How this service works

36 MCP tools & x402 pay-per-call APIs for AI agents: crypto risk, web extraction, screenshots, agent alarms, weather, company data. No API key.

## Output

Returns a JSON object containing the document's title, abstract text, license identifier (e.g. CC-BY-4.0), and canonical archive ID (e.g. pmc-13364419).

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "title": "...",
  "license": "CC-BY-4.0",
  "abstract": "...",
  "canonical_id": "pmc-13364419"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ishob-document-retrieval-by-id-c156a009/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.ishob.com](https://www.zero.xyz/host/api.ishob.com/llms.txt)