# ScholarXIV Developer Docs

> ScholarXIV Developer Platform: Papers API, dashboard, subscriptions, and integration guides.

## API Schemas

- [OpenAPI schema](https://scholarxiv.com/api/docs?format=openapi): Machine-readable API schema for tool use and API clients; rendered API reference at https://scholarxiv.com/developers/docs/api-reference

## Pages

- [Conversations](https://scholarxiv.com/developers/docs/agent-api/conversations.md): Read, list, rename, pin, archive, delete and share the conversations the agent stores for an API key.
- [Errors](https://scholarxiv.com/developers/docs/agent-api/errors.md): Status codes, the pre-stream error shape, and how to tell an incomplete stream from a failed turn.
- [FAQ](https://scholarxiv.com/developers/docs/agent-api/faq.md): Short answers about history, custom prompts, retries, plan gating and the other ScholarXIV agent surfaces.
- [Files and dictation](https://scholarxiv.com/developers/docs/agent-api/files.md): Attach documents to an agent turn and transcribe audio, using the shared upload and dictation routes.
- [Agent API](https://scholarxiv.com/developers/docs/agent-api.md): The ScholarXIV research agent as an API: one endpoint, our harness, tools, streaming, files, and saved conversations.
- [Quickstart](https://scholarxiv.com/developers/docs/agent-api/quickstart.md): Create an sxv_ key, send a message to POST /api/v1/chat, and read the JSON answer back.
- [Streaming](https://scholarxiv.com/developers/docs/agent-api/streaming.md): Stream an answer with the AI SDK UI-message event stream: text deltas, tool events, routing metadata and usage.
- [Tools and limits](https://scholarxiv.com/developers/docs/agent-api/tools.md): What the agent runs on the server, how plan entitlements gate it, and which rate limits apply.
- [Developer Dashboard](https://scholarxiv.com/developers/docs/dashboard.md): Manage API keys, test the Papers API live in the Playground, and monitor shared usage and limits.
- [Conversations](https://scholarxiv.com/developers/docs/health-api/conversations.md): Continue, retrieve, list, manage, and share health chats.
- [Errors and limits](https://scholarxiv.com/developers/docs/health-api/errors.md): Health API status codes, plan access, and request limits.
- [FAQ](https://scholarxiv.com/developers/docs/health-api/faq.md): Answers about paper-only search, account ownership, consent, tools, and health conversations.
- [Files and dictation](https://scholarxiv.com/developers/docs/health-api/files.md): Upload health documents and images, attach files, and transcribe audio.
- [Health API](https://scholarxiv.com/developers/docs/health-api.md): Health chat, medical paper search, profiles, reference lookups, files, and private health logs.
- [Health profile](https://scholarxiv.com/developers/docs/health-api/profile.md): Manage consent, saved conditions, and medications for the API key owner.
- [Quickstart](https://scholarxiv.com/developers/docs/health-api/quickstart.md): Authenticate, ask a health question, and continue the conversation.
- [Medication and condition references](https://scholarxiv.com/developers/docs/health-api/references.md): Look up medication labeling and condition definitions with related research.
- [Medical paper search](https://scholarxiv.com/developers/docs/health-api/search.md): Search the same medical evidence sources as the health chat tool, with paper results only.
- [Health logs and symptoms](https://scholarxiv.com/developers/docs/health-api/trackers.md): Create health logs, record observations, and browse symptom choices.
- [Journal Platform Research](https://scholarxiv.com/developers/docs/journal-platform-research.md)
- [Client Configuration](https://scholarxiv.com/developers/docs/mcp/clients.md): Copy-paste MCP config for opencode, Codex, Claude, Cursor, VS Code, and custom clients.
- [How to Connect](https://scholarxiv.com/developers/docs/mcp/connect.md): Endpoint URL, authentication, transport protocol, and discovery for the ScholarXIV MCP server.
- [Usage Examples](https://scholarxiv.com/developers/docs/mcp/examples.md): Multi-step research workflows showing how ScholarXIV MCP tools compose together.
- [MCP](https://scholarxiv.com/developers/docs/mcp.md): Connect AI agents and developer tools to ScholarXIV through the Model Context Protocol. 36 tools for paper search, collections, bookmarks, comments, and research.
- [Quick Start](https://scholarxiv.com/developers/docs/mcp/quickstart.md): Go from zero to your first ScholarXIV MCP tool call in 5 minutes.
- [Tool Catalog](https://scholarxiv.com/developers/docs/mcp/tools.md): Complete reference for all 45 ScholarXIV MCP tools with parameters and examples.
- [Developer Platform](https://scholarxiv.com/developers/docs.md): Papers API access powered by your ScholarXIV subscription. Create keys, test in the dashboard, and search millions of papers.
- [Authentication](https://scholarxiv.com/developers/docs/papers-api/authentication.md): Use sxv_ API keys with Bearer or x-api-key header. Keys are validated against your live subscription.
- [Errors](https://scholarxiv.com/developers/docs/papers-api/errors.md): Complete error reference, status codes, and defensive client patterns for the Papers API.
- [Code Examples](https://scholarxiv.com/developers/docs/papers-api/examples.md): Ready-to-copy examples for quickstarts, search, pagination, error handling, and production patterns.
- [FAQ](https://scholarxiv.com/developers/docs/papers-api/faq.md): Common questions about authentication, search, rate limits, plan changes, pagination, and production best practices for the Papers API.
- [Federated Search](https://scholarxiv.com/developers/docs/papers-api/federated-search.md): Search arXiv, OpenAlex, PubMed, Semantic Scholar, Crossref, and ChinaXiv at once. Merged, deduplicated results with per-source pagination.
- [Rate Limits & Quotas](https://scholarxiv.com/developers/docs/papers-api/limits.md): Your subscription controls API key quotas, hourly rate limits, and result sizes. Limits are evaluated live on every request.
- [Papers API](https://scholarxiv.com/developers/docs/papers-api.md): Search over millions of research papers with simple or advanced queries. Returns clean metadata for apps and agents.
- [Search](https://scholarxiv.com/developers/docs/papers-api/search.md): Simple title search via GET or powerful fielded search via POST. Full filter reference and pagination patterns.
- [Preprint Design Ingest Citations Profiles](https://scholarxiv.com/developers/docs/preprint-design-ingest-citations-profiles.md)
- [Preprint Phases](https://scholarxiv.com/developers/docs/preprint-phases.md)
- [Chat Completions](https://scholarxiv.com/developers/docs/router-api/completions.md): POST /api/v1/router/chat/completions — OpenAI-compatible endpoint that routes and executes in one call.
- [Dashboard](https://scholarxiv.com/developers/docs/router-api/dashboard.md): Configure the router: billing mode, your own AI Gateway key, routing profiles per API key, and per-key usage.
- [Feedback](https://scholarxiv.com/developers/docs/router-api/feedback.md): POST /api/v1/router/feedback — tell the router how its pick performed so model rankings improve.
- [Router API](https://scholarxiv.com/developers/docs/router-api.md): Send a prompt, get the model that should answer it. The same routing engine that powers Auto mode in ScholarXIV chat and health.
- [Route](https://scholarxiv.com/developers/docs/router-api/route.md): POST /api/v1/router — analyze a request and return the model that should handle it, with fallbacks.
- [Scholar Profiles And Indexing Research](https://scholarxiv.com/developers/docs/scholar-profiles-and-indexing-research.md)
- [Verify Checkout](https://scholarxiv.com/developers/docs/verify-checkout.md)