---
title: "Errors and limits"
description: "Health API status codes, plan access, and request limits."
canonical_url: "https://scholarxiv.com/developers/docs/health-api/errors"
markdown_url: "https://scholarxiv.com/developers/docs/health-api/errors.md"
---

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

# Errors and limits
URL: /developers/docs/health-api/errors
LLM index: /llms.txt
Description: Health API status codes, plan access, and request limits.
Related: health-api, health-api/quickstart

# Errors and limits

All Health API routes require an API key and Go or above. They use the account's existing [API rate limits](/developers/docs/papers-api/limits) and storage quotas.

## Status codes

| Status | Meaning                                                                                                  |
| ------ | -------------------------------------------------------------------------------------------------------- |
| 400    | Invalid parameters, malformed JSON, or invalid observation fields.                                       |
| 401    | Missing or invalid API key.                                                                              |
| 403    | Health or the requested model is unavailable on the plan, or required health-profile consent is missing. |
| 404    | Unknown conversation, condition, or health log; another account's log is also unavailable.               |
| 409    | Attachment conflict.                                                                                     |
| 413    | Oversized conversation context.                                                                          |
| 429    | API rate limit reached.                                                                                  |
| 502    | Assistant or upstream request failure.                                                                   |

Use the response's error information to identify the failing request. See [Agent API errors](/developers/docs/agent-api/errors) for the shared error contract and retry guidance.

## Request limits

- Chat messages: up to 64,000 characters; up to ten reply excerpts and five ready health attachments per turn.
- Files: up to 20 MiB each, subject to storage and per-chat limits.
- Paper search: query length 2–500 characters and 1–20 results per source.
- Health logs: each log retains its newest 180 entries; list requests accept limits from 1 to 100.

See [Quickstart](/developers/docs/health-api/quickstart), [Medical paper search](/developers/docs/health-api/search), [Files and dictation](/developers/docs/health-api/files), and [Health logs](/developers/docs/health-api/trackers) for field-level validation.

## 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).