# ISHOB Document References API

> ISHOB Document References API is a paid API for AI agents from api.ishob.com, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-15).

Returns a parsed, structured reference list (with DOIs and PMIDs where available) for a specified scholarly document

## Facts

- Endpoint: GET https://api.ishob.com/api/document/:id/references?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/ishob-document-references-api-f33edd64
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ZWTwexCo2nZACIuX6W_jj

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-references-api-f33edd64
```

Example prompt: Can you pull the full parsed reference list for document ID doc_7f3a9b2c from ISHOB, including any DOIs or PMIDs for the cited papers?

## When to prefer this

Choose this endpoint when you need machine-readable citation data (with persistent identifiers like DOIs and PMIDs) for a specific document already indexed in ISHOB. It is preferable over general web scraping for academic references because it returns pre-parsed, structured bibliographic entries. Best used when you have the ISHOB document ID and need to perform citation analysis, build a bibliography, or trace reference networks.

## Known failure modes

- Document ID not found — returns 404 or empty result
- Document has no extractable references — returns empty list
- Document is not open-licensed or accessible — returns access error
- DOIs/PMIDs unavailable for some references — returned as null or omitted fields
- Malformed document ID — returns 400 bad request
- Payment not processed — x402 payment required error

## How this service works

Parsed reference list (with DOIs/PMIDs where available) of one document

## Output

A parsed, structured array of bibliographic references extracted from the document, each entry including citation text and persistent identifiers such as DOIs and PubMed IDs (PMIDs) where available.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/ishob-document-references-api-f33edd64/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)