{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-index.sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["icon","admonition"]},"type":"markdown"},"seo":{"title":"Frequently Asked Questions","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"span","attributes":{"style":{"color":"#cdcefb","fontSize":"14px","fontWeight":"700","textTransform":"uppercase","letterSpacing":"0.05em","display":"block","marginBottom":"-30px"}},"children":["Get Started"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"frequently-asked-questions","__idx":0},"children":["Frequently Asked Questions"]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common questions about using the Anesya API."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"documents-and-processing","__idx":1},"children":["Documents and processing"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-should-i-use-documents-parsing-or-extract","__idx":2},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," When should I use documents, parsing, or extract?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["documents"]}," when you want a reusable stored file and a stable document ID."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["parsing"]}," when you need to inspect the document itself through OCR output, markdown, pictures, or page-level status details."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["extract"]}," when you already know the business structure you want and only need the final JSON result for one schema."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A common production flow is:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["upload a document"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["create a parsing"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["inspect the parsing if needed"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["create an extract from that parsing"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/documents"},"children":["Documents"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/parsing"},"children":["Parsing"]},", and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/extract"},"children":["Extract"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"can-i-send-a-public-url-instead-of-uploading-a-file-first","__idx":3},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," Can I send a public URL instead of uploading a file first?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Yes. Both parsing and extract support a public or pre-signed URL as input."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is useful when your files already live in object storage or are generated by another system."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the same file will be reused later, uploading it once through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/v0/documents"]}," is usually cleaner because you then work with a stable internal document ID instead of an external URL that may expire."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"can-i-process-multiple-documents-at-once","__idx":4},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," Can I process multiple documents at once?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Parsing documents supports a documented URL-list input. If you send a list of public or pre-signed URLs to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v0/parsing"]},", the API returns an array of parsing resources."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Extract does not document the same URL-list behavior. If you need one extract per file, the safe workflow is:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["create multiple parsings from the URL list"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["poll each parsing"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["create one extract per parsing"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/parsing"},"children":["Parsing"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"why-does-post-v0parsing-sometimes-return-an-array-instead-of-one-object","__idx":5},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," Why does POST /v0/parsing sometimes return an array instead of one object?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Because the endpoint has two create behaviors:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["one parsing object for one document input"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["an array of parsing objects when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["document"]}," is a list of URLs"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is a common integration mistake in no-code tools and coding agents. Your client should branch on the input format instead of assuming a single fixed response shape."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-do-i-reduce-unnecessary-processing","__idx":6},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," How do I reduce unnecessary processing?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The two main levers are:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["reuse stored documents and existing parsings when possible"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["trim PDFs early with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf_page_start"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf_page_end"]}," during document upload"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you only need a few pages from a long PDF, trimming at upload time is often the simplest way to reduce downstream work for both parsing and extract."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/documents"},"children":["Documents"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/credit-usage"},"children":["Credit usage"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"statuses-and-polling","__idx":7},"children":["Statuses and polling"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"why-is-my-result-not-ready-immediately-after-creation","__idx":8},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," Why is my result not ready immediately after creation?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Parsing and extract are asynchronous workflows. Creating the resource means the job has been accepted, not that the final output is ready."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v0/parsing"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /v0/extract"]},", poll the resource until it reaches a final status."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/quickstart"},"children":["API quickstart"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"what-does-partial_finished-mean","__idx":9},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," What does PARTIAL_FINISHED mean?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PARTIAL_FINISHED"]}," is a parsing status meaning the job completed but one or more pages failed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["It is not the same as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FINISHED"]},", and it is not a total failure either. Many workflows can still continue if the failed pages are not business-critical."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before deciding what to do, inspect:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pages_total"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pages_success"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pages_failed"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"which-statuses-should-stop-polling","__idx":10},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," Which statuses should stop polling?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For parsing, stop when status is:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FINISHED"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PARTIAL_FINISHED"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ERROR"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For extract, stop when status is:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FINISHED"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ERROR"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Anything else means the resource is still progressing."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"why-does-my-extract-fail-when-i-pass-a-parsing-id","__idx":11},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," Why does my extract fail when I pass a parsing ID?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The most common reason is that the parsing is not ready yet."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you create an extract from a parsing, wait for the parsing to reach a usable final state first. In practice, that means ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FINISHED"]}," or, when your workflow tolerates it, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PARTIAL_FINISHED"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/extract"},"children":["Extract"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quality-and-debugging","__idx":12},"children":["Quality and debugging"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-do-i-debug-a-poor-extract-result","__idx":13},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," How do I debug a poor extract result?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start with the parsing, not the schema output."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Extract depends on parsing. If the document content is missing, badly OCRed, or only partially processed, the extract result will also be weak."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The safest debugging sequence is:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["retrieve the parsing"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["inspect ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["markdown_content"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ocr_content"]},", and page counters"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["confirm the needed information is actually present"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["only then review the schema and extract logic"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/parsing"},"children":["Parsing"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/extract"},"children":["Extract"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"when-should-i-enable-picture-descriptions-or-table-verification","__idx":14},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," When should I enable picture descriptions or table verification?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enable ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["picture_description_enabled"]}," when image understanding matters to the workflow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Enable ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["table_verification_enabled"]}," when table accuracy matters more than keeping the request as simple as possible."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your use case does not depend on those features, leave them disabled and keep the request minimal."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-do-i-trim-a-pdf-before-parsing-or-extract","__idx":15},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," How do I trim a PDF before parsing or extract?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the query parameters on document creation:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf_page_start"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pdf_page_end"]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This trims the PDF at upload time and stores only the selected page range as the document resource you reuse later."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/documents"},"children":["Documents"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"why-does-the-document-download-endpoint-return-a-redirect","__idx":16},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," Why does the document download endpoint return a redirect?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /v0/documents/{id}/download"]}," is documented as a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["302"]}," redirect."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["That means your HTTP client must follow the redirect, or you must manually handle the returned location, to access the underlying file."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"billing-and-support","__idx":17},"children":["Billing and support"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-are-credits-calculated","__idx":18},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," How are credits calculated?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Credits are calculated per page, according to the endpoint being used."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The documented base rates are:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["parsing standard: 2 credits per page"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["extract: 3 credits per page"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["split: 2 credits per page"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["classify: 1 credit per page"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/credit-usage"},"children":["Credit usage"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-do-i-authenticate-requests","__idx":19},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," How do I authenticate requests?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Send your API key in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X-API-Key"]}," header:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl -X GET \"https://api.anesya.app/v0/documents\" \\\n  -H \"X-API-Key: $ANESYA_API_KEY\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the header is missing or invalid, the API returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["401 Unauthorized"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"where-should-i-look-when-an-api-call-fails","__idx":20},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," Where should I look when an API call fails?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start with these three checks:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the HTTP status code"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["error"]}," field on the resource when available"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["the input type you sent, especially URL vs document ID vs parsing ID"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/error-codes"},"children":["Error codes"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-do-i-contact-support","__idx":21},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"angle-right","size":"1em","color":"currentColor"},"children":[]}," How do I contact support?"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Answer"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For API issues or product questions, contact ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"mailto:support@anesya.app"},"children":["support@anesya.app"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"still-have-questions","__idx":22},"children":["Still have questions?"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/glossary"},"children":["Glossary"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/error-codes"},"children":["Error codes"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/credit-usage"},"children":["Credit usage"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/tutorials/agent-guide"},"children":["Anesya API Reference for Coding Agents"]}]}]}]},"headings":[{"value":"Frequently Asked Questions","id":"frequently-asked-questions","depth":1},{"value":"Documents and processing","id":"documents-and-processing","depth":2},{"value":"When should I use documents, parsing, or extract?","id":"when-should-i-use-documents-parsing-or-extract","depth":3},{"value":"Can I send a public URL instead of uploading a file first?","id":"can-i-send-a-public-url-instead-of-uploading-a-file-first","depth":3},{"value":"Can I process multiple documents at once?","id":"can-i-process-multiple-documents-at-once","depth":3},{"value":"Why does POST /v0/parsing sometimes return an array instead of one object?","id":"why-does-post-v0parsing-sometimes-return-an-array-instead-of-one-object","depth":3},{"value":"How do I reduce unnecessary processing?","id":"how-do-i-reduce-unnecessary-processing","depth":3},{"value":"Statuses and polling","id":"statuses-and-polling","depth":2},{"value":"Why is my result not ready immediately after creation?","id":"why-is-my-result-not-ready-immediately-after-creation","depth":3},{"value":"What does PARTIAL_FINISHED mean?","id":"what-does-partial_finished-mean","depth":3},{"value":"Which statuses should stop polling?","id":"which-statuses-should-stop-polling","depth":3},{"value":"Why does my extract fail when I pass a parsing ID?","id":"why-does-my-extract-fail-when-i-pass-a-parsing-id","depth":3},{"value":"Quality and debugging","id":"quality-and-debugging","depth":2},{"value":"How do I debug a poor extract result?","id":"how-do-i-debug-a-poor-extract-result","depth":3},{"value":"When should I enable picture descriptions or table verification?","id":"when-should-i-enable-picture-descriptions-or-table-verification","depth":3},{"value":"How do I trim a PDF before parsing or extract?","id":"how-do-i-trim-a-pdf-before-parsing-or-extract","depth":3},{"value":"Why does the document download endpoint return a redirect?","id":"why-does-the-document-download-endpoint-return-a-redirect","depth":3},{"value":"Billing and support","id":"billing-and-support","depth":2},{"value":"How are credits calculated?","id":"how-are-credits-calculated","depth":3},{"value":"How do I authenticate requests?","id":"how-do-i-authenticate-requests","depth":3},{"value":"Where should I look when an API call fails?","id":"where-should-i-look-when-an-api-call-fails","depth":3},{"value":"How do I contact support?","id":"how-do-i-contact-support","depth":3},{"value":"Still have questions?","id":"still-have-questions","depth":2}],"frontmatter":{"seo":{"title":"Frequently Asked Questions"}},"lastModified":"2026-04-22T15:07:29.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/tutorials/faq","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}