---
title: "Health API"
description: "Health chat, medical paper search, profiles, reference lookups, files, and private health logs."
canonical_url: "https://scholarxiv.com/developers/docs/health-api"
markdown_url: "https://scholarxiv.com/developers/docs/health-api.md"
---

> For the complete documentation index, see [llms.txt](/llms.txt).

# Health API
URL: /developers/docs/health-api
LLM index: /llms.txt
Description: Health chat, medical paper search, profiles, reference lookups, files, and private health logs.
Related: agent-api, papers-api/authentication, papers-api/limits, mcp/tools

# Health API

Build on the same services as `/health` using an API key from the [Developer Dashboard](/developers/dashboard/apikeys). Send `Authorization: Bearer sxv_...` or `x-api-key: sxv_...` on every API request. Health requires Go or above and uses your existing account's API rate limits and storage quotas.

All private data belongs to the **API key owner** and is shared with that account's website and MCP workspace. Keys do not create separate patient accounts. Each user of an integration needs their own account/key; never pass a user ID or use one developer key to store multiple people's profiles. Keep keys on your backend.

The machine-readable contract is available at [OpenAPI](/api/docs?format=openapi), with an interactive [API reference](/developers/docs/api-reference).

| Feature                                   | Endpoints                                                      |
| ----------------------------------------- | -------------------------------------------------------------- |
| Assistant                                 | `POST /api/v1/health/chat`, `GET /api/v1/health/chat/{chatid}` |
| Profile, saved medications and conditions | `GET`, `POST`, `DELETE /api/v1/health/profile`                 |
| Medication reference                      | `GET /api/v1/health/medication?name=metformin`                 |
| Condition reference                       | `GET /api/v1/health/condition?q=migraine`                      |
| Medical paper search                      | `GET /api/v1/health/search?q=migraine`                         |
| Symptom choices                           | `GET /api/v1/health/symptoms?kind=acute`                       |
| Health logs                               | `GET`, `POST /api/v1/health/trackers`                          |
| Individual log                            | `GET`, `DELETE /api/v1/health/trackers/{trackerId}`            |
| Record symptoms and observations          | `POST /api/v1/health/trackers/{trackerId}/entries`             |
| Files                                     | Shared `/api/v1/uploads` routes with `scope: "health"`         |

`POST /api/v1/health/chat` runs the same assistant as the website's `/health` chat: the same system prompt, health profile, medical tools, model routing, continuation, and conversation storage. Health is available on Go and above. The profile, medications, and literature tools stay on the server.

Use the [Agent API](/developers/docs/agent-api) for the research workspace. This endpoint answers health questions with the caller's health profile and the medical literature and medication tools.

## Where to start

- [Quickstart](/developers/docs/health-api/quickstart) — Authenticate, ask a health question, and continue the conversation.
- [Medical paper search](/developers/docs/health-api/search) — Search the same medical evidence sources as the health chat tool, with paper results only.
- [Health profile](/developers/docs/health-api/profile) — Manage consent, saved conditions, and medications for the API key owner.
- [Medication and condition references](/developers/docs/health-api/references) — Look up medication labeling and condition definitions with related research.
- [Health logs and symptoms](/developers/docs/health-api/trackers) — Create health logs, record observations, and browse symptom choices.
- [Files and dictation](/developers/docs/health-api/files) — Upload health documents and images, attach files, and transcribe audio.
- [Conversations](/developers/docs/health-api/conversations) — Continue, retrieve, list, manage, and share health chats.
- [Errors and limits](/developers/docs/health-api/errors) — Health API status codes, plan access, and request limits.
- [FAQ](/developers/docs/health-api/faq) — Answers about paper-only search, account ownership, consent, tools, and health conversations.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).