A callback (also called a webhook) is how JondaX delivers your processed results automatically. Instead of you checking repeatedly whether your file is ready, JondaX sends the data directly to a URL you provide — like getting a delivery notification instead of going to the post office.
If you prefer not to set up a callback, you can skip this step and download your results manually from the Transformed Files page in the portal.
Before uploading files, configure your callback endpoint on the Integration page in the JondaX client portal.
| Setting | Required | Description |
|---|---|---|
| Endpoint URL | Yes | The URL JondaX will POST results to |
| Authentication Header | No | Header name your endpoint expects for auth |
| Authentication Key | No | Header value (shown masked in the portal after saving) |
| Setting | Required | Description |
|---|---|---|
| Output Language | Yes | The language for biomarker names, categories, and comments in your output. Default: English (EN). See supported languages below. |
| Payload Type | Yes | File or Inline — Inline is only available for JSON and FHIR JSON. All other formats (HL7, FHIR XML, CSV, Parquet) are File only. Default: Inline |
| Output Format | Yes | JSON, FHIR JSON, HL7, FHIR XML, CSV, Parquet. Default: JSON. |
| Original results in output | No | When enabled, includes raw source data alongside transformed results in the callback payload. Disabled by default. |
JondaX can translate the human-readable parts of your output — biomarker names, categories, specimen types, and comments — into your preferred language. Numeric values, units, LOINC codes, and scores are never translated (they are universal).
| Code | Language |
|---|---|
EN | English (default — no translation applied) |
ES | Spanish |
DE | German |
ZH | Chinese |
- You select your output language on the Integration page under Output Settings
- When your file finishes processing and is approved, JondaX translates the relevant fields automatically
- The translated output is delivered to your callback URL (or available for download on the Transformed Files page)
| Translated | Not translated |
|---|---|
| Biomarker names | LOINC codes |
| Category / sub-category labels | Numeric values and ranges |
| Specimen types | Units of measurement |
| Comments | Confidence scores |
| Diagnosis descriptions | Dates and timestamps |
- Translation happens after review approval — it adds 1–5 seconds before delivery (runs in the background, no delay visible to you)
- If you change your output language, it only applies to new files processed after the change
- If you download a file before translation completes, you'll receive the English version with a note that translation is in progress — just download again shortly after
- The source language of the lab report does not need to match the output language — JondaX handles any input language
You may receive up to two callbacks per upload, depending on how your results are processed.
After your file is processed, JondaX automatically verifies each biomarker result against its quality checks. Results that pass are delivered to your callback URL right away — you don't need to wait for the full review cycle.
This early callback contains only the results that passed automated verification. The qaPassed field tells you how many results were verified, and manualReview tells you how many are still under review.
If any results require manual review by our team, a second callback is sent once that review is complete. This callback contains the reviewed results.
You can identify which callback you're receiving by comparing the
qaPassedandmanualReviewcounts. ThetotalTestsfield is always the same across both callbacks and represents the total number of biomarkers in the upload.
When all results pass automated verification, you receive a single callback with the complete result set. No second callback is sent.
| Scenario | Callbacks you receive |
|---|---|
| All results pass automated checks | 1 — full result set |
| Some results need manual review | 2 — first with verified results, second with reviewed results |
Your callback endpoint should handle both scenarios. The simplest approach is to accumulate results by
uploadIdand usetotalTeststo know when you have all results.
If your callback endpoint is unreachable or returns a non-2xx status, JondaX retries delivery up to 3 times:
| Attempt | Timing |
|---|---|
| 1st retry | Immediately after failure |
| 2nd retry | 30 minutes later |
| 3rd retry | 6 hours later |
If all retries fail, the result is stored for 30 days and can be retrieved by contacting support.
Use the status polling endpoint to inspect whether your callback was delivered:
GET https://app.jondax.eu/api/v1/status/:uploadId
Authorization: Bearer <JONDAX_API_KEY>The callbackDelivery.status field reports one of: pending, delivered, retrying, or exhausted. See the Status Polling section for full details.
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.
IP allowlisting will be available in a future release.