{"removeAttribution":false,"l10n":{"translations":{"default_locale":{"translation":{}}},"defaultLocale":"default_locale","locales":[{"code":"default_locale","name":"default_locale"}]},"logo":{"image":"/assets/anesya.2395f70a797a4017dae858d4a061cb4c57537c79161caa88539a6a768845fa40.8a5edab2.png","altText":"Anesya logo","link":"https://framerusercontent.com/images/rYglIAI2OBRd0HbYDGRaMIYIIA.svg","favicon":"/assets/anesya.2395f70a797a4017dae858d4a061cb4c57537c79161caa88539a6a768845fa40.8a5edab2.png"},"navbar":{"items":[{"type":"link","fsPath":"index.md","metadata":{"type":"markdown"},"label":"Documentation","link":"/","linePosition":"top","routeSlug":"/","icon":"book"},{"type":"link","fsPath":"API/schema.yaml","metadata":{"type":"openapi","title":"API Quickstart","description":"Get up and running with the **Anesya Public API** in minutes.\n\nThe public API is designed around a simple workflow:\n\n* [Upload a document](/api/schema/documents/document_create)\n* [Create a parsing resource](/api/schema/parsings/parsing_create)\n* [Create an extract resource from a schema](/api/schema/extracts/extract_create)\n\n---\n\n## Prerequisites\n\n{% admonition type=\"info\" name=\"Create an account and an API token\" %}\n  Before sending your first API request, <a href=\"https://dashboard.anesya.app/api\" target='_blank'>create an Anesya account</a> and [generate an API token](/tutorials/api_key) from the dashboard.\n{% /admonition %}\n\nAnesya endpoints use the `X-API-Key` header:\n\n```http\nX-API-Key: <YOUR_API_KEY>\n```\n\n> Important: do not share your token and never commit it to Git.\n\n---\n\n## Quickstart\n\nThe fastest way to get started is:\n\n1. [Upload a file](/api/schema/documents/document_create) with `POST /v0/documents`\n2. [Create a parsing](/api/schema/parsings/parsing_create) with `POST /v0/parsing`\n3. [Poll the parsing](/api/schema/parsings/parsing_retrieve) until its status reaches a final state\n4. [Create an extract](/api/schema/extracts/extract_create) with `POST /v0/extract`\n5. [Poll the extract](/api/schema/extracts/extract_retrieve) until its status reaches a final state\n\n### Which Endpoint To Use\n\n* Use [documents](/api/schema/documents/document_list) when you want to store uploaded files, [retrieve them](/api/schema/documents/document_retrieve), and [reuse them later in a parsing](/api/schema/parsings/parsing_create).\n* Use [parsing](/api/schema/parsings/parsing_list) when you need OCR output, markdown content, and page-level parsing data, or when you want to [check processing status](/api/schema/parsings/parsing_retrieve).\n* Use [extract](/api/schema/extracts/extract_create) when you want structured output generated from a schema and then [retrieve the final result](/api/schema/extracts/extract_retrieve).\n\n---\n\n## Common Error Codes\n\n| HTTP Code | Description                             |\n| --------- | --------------------------------------- |\n| `200`     | Resource retrieved successfully         |\n| `201`     | Resource created and processing started |\n| `400`     | Missing or invalid fields               |\n| `401`     | Missing or invalid authentication       |\n| `404`     | Resource not found                      |\n\n---\n\nNeed help? Contact us at [support@anesya.app](mailto:support@anesya.app).\n"},"label":"API Reference","link":"/api/schema","linePosition":"top","routeSlug":"/api/schema","icon":"code"}]},"markdown":{"frontMatterKeysToResolve":["image","links"],"partialsFolders":["**/_partials/**"],"lastUpdatedBlock":{"format":"timeago"},"toc":{"header":"On this page","depth":3},"editPage":{}},"openapi":{"hideDownloadButton":true},"mcp":{"hide":false,"docs":{"hide":false,"name":"MCP server","ignore":[]}},"banner":[],"breadcrumbs":{"prefixItems":[]},"userMenu":{"hide":true},"auth":{"idpsInfo":[]},"search":{},"entitiesCatalog":{},"apiProducts":{},"searchFeatures":{"advanced":{"enabled":false},"ai":{"enabled":false}},"analytics":{"ga":{"trackingId":"","exclude":[],"trackers":{}}}}