Skip to contentSkip to content

Quickstart ​

The public API is not yet available for integration. This page shows how to submit a file and processing options in one request; see the API reference for all fields and response formats.

1. Create an API key ​

Create a key in your account and treat it as a secret. Send API requests from your server; do not put the key in browser code.

2. Submit a file for processing ​

Send the file and processing options together as multipart/form-data:

bash
curl --request POST 'https://lissa.health/api/v1/documents' \
  --header 'Authorization: Bearer <API_KEY>' \
  --form 'file=@report.pdf;type=application/pdf' \
  --form 'request={"idempotency_key":"report-001","wait_seconds":5,"features":["text","biomarkers"]};type=application/json'

Put idempotency_key in the JSON body and reuse it when retrying the same operation. wait_seconds sets a bounded wait: 0 returns the job immediately; values from 1 to 10 may return the completed result. If processing takes longer, the response contains the accepted job.

If the file was already uploaded with POST /api/v1/files, submit it by file_id in a JSON request:

http
POST /api/v1/documents
Authorization: Bearer <API_KEY>
Content-Type: application/json

{
  "file": {
    "file_id": "file_..."
  },
  "idempotency_key": "report-001",
  "wait_seconds": 5,
  "features": ["text", "biomarkers"]
}

3. Retrieve the result ​

For a 202 response, check the job with GET /api/v1/jobs/{job_id}. When the result is available, retrieve it with GET /api/v1/jobs/{job_id}/result. If the request times out, retry the original POST with the same idempotency_key.

See the API reference for request parameters and response formats.

ООО «Алвита» — разработчик Lissa Health