{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Result Retrieval — Pathology — JondaX API Docs","description":"Retrieve extracted pathology results directly by uploadId using API key authentication.","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"result-retrieval","__idx":0},"children":["Result Retrieval"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In addition to receiving results via ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/pathology/callback-config"},"children":["Callbacks"]},", you can query and retrieve transformed pathology data directly using the Result Retrieval endpoint."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is ideal for:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Systems where inbound webhooks cannot be received or configured."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["On-demand result polling and fetching."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Directly downloading results within 30 days of upload time."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"endpoint","__idx":1},"children":["Endpoint"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"http","header":{"controls":{"copy":{}}},"source":"GET https://app.jondax.eu/api/v1/results/:uploadId\nAuthorization: Bearer <JONDAX_API_KEY>\n","lang":"http"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Results are returned formatted in your account's configured webhook output format (JSON, FHIR JSON, HL7, FHIR XML, CSV, or Parquet)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"parameters","__idx":2},"children":["Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"In"},"children":["In"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uploadId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (UUID)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["path"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The unique ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UploadId"]}," received during upload."]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"request-example","__idx":3},"children":["Request Example"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --location 'https://app.jondax.eu/api/v1/results/<uploadId>' \\\n--header 'Authorization: Bearer <JONDAX_API_KEY>'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"http-status-codes--responses","__idx":4},"children":["HTTP Status Codes & Responses"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-http-200-ok-completed","__idx":5},"children":["1. HTTP 200 OK (Completed)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When processing is complete, the endpoint returns the structured output matching your configured output format:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"json--content-type-applicationjson-","__idx":6},"children":["JSON (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type: application/json"]},")"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"customerId\": 11,\n  \"fileName\": \"lab_report_blood.pdf\",\n  \"results\": [\n    {\n      \"Date\": \"2026-06-03\",\n      \"Biomarker-Name\": \"Hemoglobin\",\n      \"Result\": \"14.2\",\n      \"Unit\": \"g/dL\",\n      \"Low-Ref-Range\": \"13.0\",\n      \"High-Ref-Range\": \"17.0\",\n      \"Interpretation\": \"Normal\",\n      \"LOINC-Code\": \"718-7\"\n    },\n    {\n      \"Date\": \"2026-06-03\",\n      \"Biomarker-Name\": \"WBC\",\n      \"Result\": \"6.8\",\n      \"Unit\": \"10^3/uL\",\n      \"Low-Ref-Range\": \"4.0\",\n      \"High-Ref-Range\": \"11.0\",\n      \"Interpretation\": \"Normal\",\n      \"LOINC-Code\": \"6690-2\"\n    }\n  ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"fhir-json--content-type-applicationfhirjson-","__idx":7},"children":["FHIR JSON (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type: application/fhir+json"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns a standard FHIR ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DiagnosticReport"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Observation"]}," Bundle."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"hl7-v2--content-type-textplain-with-content-disposition-","__idx":8},"children":["HL7 v2 (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Type: text/plain"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content-Disposition"]},")"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"text","header":{"controls":{"copy":{}}},"source":"MSH|^~\\&|JONDAX|LAB|||20260603120000||ORU^R01|...\nPID|1||PAT12345||DOE^JOHN||19800101|M\nOBR|1|||LAB^Pathology Report|||20260603\nOBX|1|NM|718-7^Hemoglobin^LN||14.2|g/dL|13.0-17.0|N|||F\n","lang":"text"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-http-202-accepted-in-progress","__idx":9},"children":["2. HTTP 202 Accepted (In Progress)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If the document is still in queue or processing, the endpoint returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202 Accepted"]}," indicating that the result is not yet ready:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"status\": \"In Progress\",\n  \"uploadId\": \"<uploadId>\",\n  \"message\": \"Document is currently being processed\",\n  \"statusUrl\": \"/api/v1/results/<uploadId>\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Polling Recommendation:"]}," When receiving ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["202 Accepted"]},", wait ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["5–10 seconds"]}," before making the next request."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"3-http-401-unauthorized","__idx":10},"children":["3. HTTP 401 Unauthorized"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returned if the API key is missing or invalid."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"statusCode\": 401,\n  \"message\": \"Invalid or missing API key\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"4-http-403-forbidden","__idx":11},"children":["4. HTTP 403 Forbidden"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returned if the requested ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uploadId"]}," belongs to another customer account."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"statusCode\": 403,\n  \"message\": \"You do not have permission to access this upload result\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"5-http-404-not-found","__idx":12},"children":["5. HTTP 404 Not Found"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returned if the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["uploadId"]}," does not exist or has exceeded the 30-day retention window."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"statusCode\": 404,\n  \"message\": \"Result not found or expired (> 30 days)\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"6-http-422-unprocessable-entity","__idx":13},"children":["6. HTTP 422 Unprocessable Entity"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returned if document processing failed (e.g. unreadable scan or corrupted file)."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"success\": false,\n  \"statusCode\": 422,\n  \"message\": \"Document processing failed. Please verify file quality or re-upload.\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"data-retention","__idx":14},"children":["Data Retention"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All upload results and files are accessible via the Result Retrieval endpoint for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["30 days"]}," following upload. After 30 days, files and records are automatically purged."]}]},"headings":[{"value":"Result Retrieval","id":"result-retrieval","depth":1},{"value":"Endpoint","id":"endpoint","depth":2},{"value":"Parameters","id":"parameters","depth":3},{"value":"Request Example","id":"request-example","depth":2},{"value":"HTTP Status Codes & Responses","id":"http-status-codes--responses","depth":2},{"value":"1. HTTP 200 OK (Completed)","id":"1-http-200-ok-completed","depth":3},{"value":"JSON ( Content-Type: application/json )","id":"json--content-type-applicationjson-","depth":4},{"value":"FHIR JSON ( Content-Type: application/fhir+json )","id":"fhir-json--content-type-applicationfhirjson-","depth":4},{"value":"HL7 v2 ( Content-Type: text/plain with Content-Disposition )","id":"hl7-v2--content-type-textplain-with-content-disposition-","depth":4},{"value":"2. HTTP 202 Accepted (In Progress)","id":"2-http-202-accepted-in-progress","depth":3},{"value":"3. HTTP 401 Unauthorized","id":"3-http-401-unauthorized","depth":3},{"value":"4. HTTP 403 Forbidden","id":"4-http-403-forbidden","depth":3},{"value":"5. HTTP 404 Not Found","id":"5-http-404-not-found","depth":3},{"value":"6. HTTP 422 Unprocessable Entity","id":"6-http-422-unprocessable-entity","depth":3},{"value":"Data Retention","id":"data-retention","depth":2}],"frontmatter":{"seo":{"title":"Result Retrieval — Pathology — JondaX API Docs","description":"Retrieve extracted pathology results directly by uploadId using API key authentication."}},"lastModified":"2026-08-28T05:53:25.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/pathology/result-retrieval","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}