# Quickstart

## Before you begin

Make sure you have completed these steps on the **Integration** page in your JondaX client portal before uploading files.

![Integration page setup overview](/assets/integration-page-overview.ef0b1c71fa49456fd1b9468f55673d1ac3b90da5bab51319c82fde65318d8508.a1161040.png)

| Step | What to do | Where to find it | Required? |
|  --- | --- | --- | --- |
| 1 | **Log in** to the JondaX client portal | [app.jondax.eu](https://app.jondax.eu) | Yes |
| 2 | **Copy your API key** | Integration page → API Key section | Yes |
| 3 | **Set your Callback URL** | Integration page → Endpoint URL | Optional — only if you want results delivered to your server |
| 4 | **Choose your output language** (English, Spanish, German, Chinese) | Integration page → Output Settings | Yes (default: English) |
| 5 | **Choose your output format** (JSON, HL7, FHIR, etc.) | Integration page → Output Settings | Yes (default: Inline JSON) |


> **Don't want to set up a callback?** That's fine. You can skip step 3 and download your processed files directly from the **Transformed Files** page in the portal instead.
If you only use the **Medical Device** module, steps 3 and 4 don't apply — results are returned immediately in the API response.


## Choose your upload method

Via API
Use the API for automated, high-volume, or server-to-server integrations.

> **New to curl?** The commands below are run in your computer's terminal — on Mac open the **Terminal** app, on Windows open **Command Prompt** or **PowerShell**. Copy the command, replace the placeholder values (your API key and file path), and press Enter. If you'd rather skip the terminal entirely, use the [Upload Widget](/docs/upload-widget) tab instead.


Pathology
### First call in 5 minutes

#### 1. Get your API key

Retrieve your API key from the **Integration** section under **Settings** in the JondaX client portal.

![API key location on Integration page](/assets/integration-api-key.508592ff43193fc58c08c0bac876f6d9c787a2a3a4ca88816c7e6afecd5c2ddd.a1161040.png)

#### 2. Configure your callback

On the Integration page, set your **Endpoint URL** and optionally an authentication header name + value so JondaX can authenticate with your server.

![Callback configuration](/assets/callback-config-form.7fb46fc5e5a0ea4c4d0432183731e3a445ef686af3ee31b15a3b0ff78a4f1b65.a1161040.png)

#### 3. Upload a file

Send your lab report (PDF or image) using a multipart form request. Replace `<JONDAX_API_KEY>` with your actual API key and update the file path to point to your document.

```bash
curl --location 'https://app.jondax.eu/api/master?module=pathology' \
--header 'Authorization: Bearer <JONDAX_API_KEY>' \
--form 'deviceImage=@"/path/to/lab-report.pdf"'
```

#### 4. Receive confirmation

The API responds immediately with an `UploadId` for each uploaded file:

```json
{
  "success": true,
  "data": {
    "type": "pathology",
    "status": "uploaded",
    "uploads": [
      {
        "uploadId": "<uploadId>",
        "fileName": "E46UNRB_96dpi_1.png",
        "message": "File uploaded successfully"
      }
    ],
    "filesCount": 1,
    "message": "1 pathology file(s) uploaded successfully"
  }
}
```

#### 5. Receive results at your callback or retrieve directly

JondaX POSTs the structured output to the Endpoint URL you configured. The format (JSON, HL7, FHIR, CSV, Parquet) depends on your Integration settings. See [Callback Payloads](/docs/pathology/callback-payloads).

Alternatively, you can retrieve the transformed results directly within 30 days from uploaded time via the [Result Retrieval API](/docs/pathology/result-retrieval):

```bash
curl --location 'https://app.jondax.eu/api/v1/results/<UploadId>' \
--header 'Authorization: Bearer <JONDAX_API_KEY>'
```

You can also download the transformed files from the **Transformed Files** page in the client portal.

![Transformed Files page](/assets/transformed-files-page.fbf32d0b693850b0b7216c49bd72ca1320702c96dc8c91f756590e082b89c682.a1161040.png)

Medical Device
### First call in 5 minutes

#### 1. Get your API key

Retrieve your API key from the **Integration** section under **Settings** in the JondaX client portal.

#### 2. Upload a device image

```bash
curl --location 'https://app.jondax.eu/api/master?module=medical' \
--header 'Authorization: Bearer <JONDAX_API_KEY>' \
--form 'deviceImage=@"/path/to/glucosemeter.jpg"'
```

#### 3. Receive extracted data immediately

```json
{
  "success": true,
  "data": {
    "type": "medical",
    "extractions": [
      {
        "fileName": "glucosemeter.jpg",
        "result": {
          "status": "extracted",
          "success": true,
          "count": 1,
          "items": [
            {
              "index": 0,
              "deviceType": "glucose-meter",
              "data": {
                "glucose": {
                  "value": 5.8,
                  "unit": "mg/dL"
                },
                "unit": "mmol/L"
              }
            }
          ],
          "timestamp": "2026-08-28T04:38:15.672Z",
          "processingTime": "2619ms",
          "message": "Medical data extracted successfully from JPG file"
        }
      }
    ],
    "filesCount": 1,
    "message": "1 medical file(s) processed successfully"
  }
}
```

No callback configuration required for the Medical Device module.

Via Upload Widget
Use the [Upload Widget](/docs/upload-widget) for a quick test, occasional uploads, or if you prefer a visual interface over terminal commands. No coding or curl knowledge required.

### Where to find the widget

The Upload Widget is on the **Integration** page in your JondaX client portal.

![Upload Widget location](/assets/widget-integration-page.ab4a2ed90af5fb61fede07b39aac94a019f4c1ec5dddfcdd1e8cbaa1217903f5.a1161040.png)

### Upload a Pathology file

1. Go to the **Integration** page
2. Click on **Upload File** button
3. Select **Pathology** as the module
4. Drag and drop your lab report (PDF or image) onto the widget — or click to browse
5. The widget uploads the file and shows a confirmation with your `UploadId`
6. Results are delivered to your configured callback URL


![Pathology upload via widget](/assets/widget-pathology-upload.4d6cb455b2570e5db03a79eafe97a9ea660ea0e45e4beeda0a9dd327e94d5b9e.a1161040.png)

### Upload a Medical Device image

1. Go to the **Integration** page
2. Click on **Upload File** button
3. Select **Medical Device** as the module
4. Drop your device reading image onto the widget
5. The extracted data appears **immediately in the widget output section** below the upload area — no callback or separate page needed


Since Medical Device processing is synchronous, results (device type, readings with units) are displayed directly in the widget as soon as processing completes.

![Medical device results in widget output](/assets/widget-medical-output.021cfc13b354891bd3676ffc3c99bf01c9caf8924b11a0bfb6b8948e875f9afd.a1161040.png)

### When to use the widget

- First-time testing without any setup
- Quick one-off uploads by team members
- Verifying that your account and callback are working before writing integration code


For full widget documentation including embedding in your own app, see the [Upload Widget guide](/docs/upload-widget).