API reference

1. Post the inputs

   Send JSON or ordinary form data. No authentication, no CSRF token, no API key.

   curl -X POST https://www.athanortools.com/api/rdkit/ \
     -H 'Content-Type: application/json' \
     -d '{
     "operation": "descriptors",
     "smiles": "CC(=O)OC1=CC=CC=C1C(=O)O",
     "include_inchi": false
   }'

2. Read the job back

   The response is 202 Accepted. Nothing has run yet: one job executes at a time across the whole site, and position counts how many are ahead of this one.

   {
     "ok": true,
     "job": {
       "id": "9f1c8a2be5f0417d",
       "tool": "rdkit",
       "status": "queued",
       "status_url": "/api/jobs/9f1c8a2be5f0417d/",
       "submitted_at": "2026-01-01T00:00:00+00:00",
       "started_at": null,
       "finished_at": null,
       "position": 0
     }
   }

3. Poll status_url until it settles

   That is GET /api/jobs/%3Cjob_id%3E/, returned with the job so it never has to be assembled by hand. Poll every second or so. A finished job carries either result or error, and finished jobs are dropped once enough newer ones arrive, so collect the result rather than leaving it on the server.

   curl https://www.athanortools.com/api/jobs/9f1c8a2be5f0417d/

   {
     "ok": true,
     "job": {
       "id": "9f1c8a2be5f0417d",
       "tool": "rdkit",
       "status": "succeeded",
       "finished_at": "2026-01-01T00:00:02+00:00",
       "result": { "…": "whatever the tool returned" },
       "license": { "type": "…", "details": "…" }
     }
   }

Job statuses

Error codes

Every error is {"ok": false, "error": {"code": …, "message": …}}, whether it comes back from the request itself or from a failed job's error.

Molecule entries

A molecule_builder field holds one entry per chain, ligand, or ion. Chain letters (A, B, C, …) are assigned in the order the entries appear, so a request never carries one.