{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Callback Configuration — Pathology — JondaX API Docs","description":"Configure your callback endpoint for JondaX Pathology results. Set your endpoint URL, authentication headers, output format, and retry behavior.","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":"callback-configuration","__idx":0},"children":["Callback Configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before uploading files, configure your callback endpoint on the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Integration"]}," page in the JondaX client portal."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"your-systems-url-and-keys","__idx":1},"children":["Your system's URL and keys"]},{"$$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":"Setting"},"children":["Setting"]},{"$$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":["Endpoint URL"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The URL JondaX will POST results to"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication Header"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Header name your endpoint expects for auth"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication Key"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Header value (shown masked in the portal after saving)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"output-settings","__idx":2},"children":["Output settings"]},{"$$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":"Setting"},"children":["Setting"]},{"$$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":["Payload Type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["File"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Inline"]}," — Inline is only available for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["JSON"]}," and ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["FHIR JSON"]},". All other formats (HL7, FHIR XML, CSV, Parquet) are File only."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Output Format"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["JSON"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FHIR JSON"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HL7"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["FHIR XML"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CSV"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Parquet"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Original results in output"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["When enabled, includes raw source data alongside transformed results in the callback payload. Disabled by default."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"retry-behavior","__idx":3},"children":["Retry behavior"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your callback endpoint is unreachable or returns a non-2xx status, JondaX retries delivery up to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3 times"]},":"]},{"$$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":"Attempt"},"children":["Attempt"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Timing"},"children":["Timing"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1st retry"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Immediately after failure"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2nd retry"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["30 minutes later"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3rd retry"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["6 hours later"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If all retries fail, the result is stored for ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["30 days"]}," and can be retrieved by contacting support."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"checking-delivery-status","__idx":4},"children":["Checking delivery status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use the status polling endpoint to inspect whether your callback was delivered:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"GET https://app.jondax.eu/api/v1/status/:uploadId\nAuthorization: Bearer <JONDAX_API_KEY>\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["callbackDelivery.status"]}," field reports one of: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pending"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["delivered"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["retrying"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["exhausted"]},". See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#status-polling"},"children":["Status Polling"]}," section for full details."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"verifying-callback-authenticity","__idx":5},"children":["Verifying callback authenticity"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["JondaX sends the authentication header name and value you configured on the Integration page with every callback. Verify this header matches your expected value to confirm the request is genuine."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["IP allowlisting will be available in a future release."]}]}]},"headings":[{"value":"Callback Configuration","id":"callback-configuration","depth":1},{"value":"Your system's URL and keys","id":"your-systems-url-and-keys","depth":2},{"value":"Output settings","id":"output-settings","depth":2},{"value":"Retry behavior","id":"retry-behavior","depth":2},{"value":"Checking delivery status","id":"checking-delivery-status","depth":2},{"value":"Verifying callback authenticity","id":"verifying-callback-authenticity","depth":2}],"frontmatter":{"seo":{"title":"Callback Configuration — Pathology — JondaX API Docs","description":"Configure your callback endpoint for JondaX Pathology results. Set your endpoint URL, authentication headers, output format, and retry behavior."}},"lastModified":"2026-07-07T05:23:45.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/pathology/callback-config","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}