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:
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:
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.