LIS integration

LIS configuration is available on the Standard and Enterprise plans 
Go to the LIS page. If LIS Integration is available, your LIS can make requests to the Celly.AI server and get analysis results.
Use basic authentication for all requests with Organization ID as login and Secret key as password. Organization ID and Secret key can be found at https://app.celly.ai/lis/​
Celly.AI provides APIs that return analysis results to LIS:
1.​https://app.celly.ai/api/lis/v1/analysis/kinds - returns a list of id and corresponding analysis types
curl -X GET "https://app.celly.ai/api/lis/v1/analysis/kinds" -H "accept: application/json" -H "authorization: Basic $credentialsquot;
1
[
2
  {
3
    "id": 0,
4
    "name": "Blood: CBC"
5
  },
6
  {
7
    "id": 1,
8
    "name": "Bone marrow: WBC-differential"
9
  },
10
  {
11
    "id": 2,
12
    "name": "Malaria thin: parasites detection"
13
  },
14
  {
15
    "id": 3,
16
    "name": "Malaria thin: parasites counting"
17
  },
18
  {
19
    "id": 5,
20
    "name": "Malaria thick: parasites counting"
21
  },
22
  {
23
    "id": 6,
24
    "name": "Blood: PLT counting (Fonio)"
25
  },
26
  {
27
    "id": 7,
28
    "name": "Canine Blood: CBC"
29
  },
30
  {
31
    "id": 8,
32
    "name": "Feline Blood: CBC"
33
  },
34
  {
35
    "id": 9,
36
    "name": "Canine Blood: CBC, 40x"
37
  },
38
  {
39
    "id": 10,
40
    "name": "Blood: CBC, 40x"
41
  },
42
  {
43
    "id": 11,
44
    "name": "Feline Blood: CBC, 40x"
45
  },
46
  {
47
    "id": 14,
48
    "name": "Pap (liquid-based), 40x"
49
  },
50
  {
51
    "id": 12,
52
    "name": "Canine Reticulocytes, 100x"
53
  },
54
  {
55
    "id": 13,
56
    "name": "Feline Reticulocytes, 100x"
57
  }
58
]
Copied!
2.​https://app.celly.ai/api/lis/v1/analysis/statuses - returns a list of id and corresponding analysis statuses
curl -X GET "https://app.celly.ai/api/lis/v1/analysis/statuses" -H "accept: application/json" -H "authorization: Basic $credentialsquot;
1
[
2
  {
3
    "id": 6,
4
    "name": "Pending"
5
  },
6
  {
7
    "id": 0,
8
    "name": "Active"
9
  },
10
  {
11
    "id": 1,
12
    "name": "Post Processing"
13
  },
14
  {
15
    "id": 2,
16
    "name": "In Review"
17
  },
18
  {
19
    "id": 3,
20
    "name": "Approved"
21
  },
22
  {
23
    "id": 4,
24
    "name": "Rejected"
25
  },
26
  {
27
    "id": 5,
28
    "name": "Error"
29
  }
30
]
Copied!
3.​https://app.celly.ai/api/lis/v1/analysis - provides a list of all tests (in In Review / Approved / Rejected status) of your organization, except Panorama kind tests
curl -X GET "https://app.celly.ai/api/lis/v1/analysis?page=1&page_size=3" -H "accept: application/json" -H "authorization: Basic $credentialsquot;
To list the tests that have not yet been submitted to LIS use sent_to_lis=False
To filter by status and kind use kind=id and status=id respectively
Use page_size to customize the page size, default is 20
Use page to navigate between pages
count - total number of filtered tests, previous/next - link to get previous/next page
1
{
2
  "count": 107,
3
  "next": "http://app.celly.ai/api/lis/v1/analysis?page=2&page_size=3",
4
  "previous": null,
5
  "results": [
6
    {
7
      "test_id": 16914,
8
      "description": "94111395",
9
      "kind": {
10
        "id": 0,
11
        "name": "Blood: CBC"
12
      },
13
      "status": {
14
        "id": 2,
15
        "name": "In Review"
16
      },
17
      "sent_to_lis": false,
18
      "started_at": "2021-12-27T13:03:38.718838+03:00",
19
      "duration_sec": 632
20
    },
21
    {
22
      "test_id": 16913,
23
      "description": "9919268438",
24
      "kind": {
25
        "id": 0,
26
        "name": "Blood: CBC"
27
      },
28
      "status": {
29
        "id": 2,
30
        "name": "In Review"
31
      },
32
      "sent_to_lis": false,
33
      "started_at": "2021-12-27T12:58:24.264011+03:00",
34
      "duration_sec": 190
35
    },
36
    {
37
      "test_id": 16912,
38
      "description": "9919266523",
39
      "kind": {
40
        "id": 0,
41
        "name": "Blood: CBC"
42
      },
43
      "status": {
44
        "id": 2,
45
        "name": "In Review"
46
      },
47
      "sent_to_lis": false,
48
      "started_at": "2021-12-27T12:38:38.224161+03:00",
49
      "duration_sec": 200
50
    }
51
  ]
52
}
Copied!
4.​https://app.celly.ai/api/lis/v1/analysis/{test_id} - provides results for the given test_id 
GET: returns results (format is described below) 
PATCH: returns results + marks the test as submitted to LIS (sent_to_lis=True)
Analysis result format:
1
"test_id" – unique test id in the Celly.AI database
2
"sent_to_lis" - is test marked as submitted to LIS? (bool)
3
"created_at" – created date (string)
4
"finished_at" – finished date(string)
5
"description" –  test description. Slide id from LIS will be here (string)
6
"conclusion" – conclusion text (string)
7
"kind_id" –  test type id
8
"status_id" - test status id
9
"user" –  user that performed the test (string)
10
"flags" –  report flags (json)
11
"snapshots"  - snapshot urls (array of strings)
12
"cell_counts" – cells number and images (json)
Copied!
Result example (CBC test)
1
{
2
   "test_id":16914,
3
   "lis_id":null,
4
   "sent_to_lis":false,
5
   "created_at":"2021-12-27 10:03:38.448056+00:00",
6
   "finished_at":"2021-12-27 10:14:10.965686+00:00",
7
   "description":"94111395",
8
   "conclusion":null,
9
   "kind_id":0,
10
   "status_id":2,
11
   "user":"Dialab",
12
   "snapshots":[
13
      "https://cdn.celly.ai/website/media/app/...",
14
      ...
15
   ],
16
   "cell_counts":{
17
      "backend":[
18
         {
19
            "name":"Segmented Neutrophil",
20
            "count":63,
21
            "ratio":70,
22
            "images":[
23
               "https://cdn.celly.ai/website/media/app/...",
24
               ...
25
            ]
26
         },
27
         ...
28
         {
29
            "name":"Total",
30
            "count":90,
31
            "ratio":100
32
         },
33
         {
34
            "name":"Unclassified",
35
            "count":8
36
         }
37
      ],
38
      "rbc_size":[
39
         {
40
            "name":"Normocytosis",
41
            "count":294,
42
            "ratio":98,
43
            "images":[
44
               "https://cdn.celly.ai/website/media/app/...",
45
               ...
46
            ]
47
         },
48
         ...
49
         {
50
            "name":"Total",
51
            "count":300,
52
            "ratio":100
53
         }
54
      ],
55
      "rbc_color":[
56
         {
57
            "name":"Normochromia",
58
            "count":300,
59
            "ratio":100,
60
            "images":[
61
               "https://cdn.celly.ai/website/media/app/...",
62
               ...
63
            ]
64
         },
65
         ...
66
         {
67
            "name":"Total",
68
            "count":300,
69
            "ratio":100
70
         }
71
      ],
72
      "rbc_shape":[
73
         {
74
            "name":"Normal",
75
            "count":288,
76
            "ratio":100,
77
            "images":[
78
               "https://cdn.celly.ai/website/media/app/...",
79
               ...
80
            ]
81
         },
82
         ...
83
         {
84
            "name":"Total",
85
            "count":288,
86
            "ratio":100
87
         },
88
         {
89
            "name":"Unclassified",
90
            "count":12
91
         }
92
      ],
93
      "rbc_inc":[
94
         {
95
            "name":"Parasites",
96
            "count":215,
97
            "ratio":71.7,
98
            "images":[
99
               "https://cdn.celly.ai/website/media/app/...",
100
               ...
101
            ]
102
         },
103
         ...
104
         {
105
            "name":"Total",
106
            "count":300,
107
            "ratio":100
108
         }
109
      ]
110
   },
111
   "flags":{
112
      "wbc":{
113
         "Megaloblasts":0,
114
         "Neutrophil hypersegmentation":0,
115
         "Toxic granulation of neutrophils":0,
116
         "Erythro, normoblasts":0
117
      },
118
      "plt":{
119
         "Giant PLT":0,
120
         "Clumps":0
121
      },
122
      "rbc":{
123
         "Anisocytosis":0,
124
         "Microcytosis":0,
125
         "Macrocytosis":0,
126
         "Anisochromia":0,
127
         "Hypochromia":0,
128
         "Hyperchromia":0,
129
         "Poikilocytosis":0,
130
         "Kodocytes":0,
131
         "Schizocytes":0,
132
         "Spherocytes":0,
133
         "Ovalocytes":0,
134
         "Teardrop":0,
135
         "Stomatocytes":0,
136
         "Acanthocytes":0,
137
         "Echinocytes":0,
138
         "Drepanocytes":0,
139
         "Parasites":0,
140
         "Cabot rings":0,
141
         "Howell-Jolly bodies":0,
142
         "Pappenheimer bodies":0,
143
         "Basophilic stippling":0
144
      }
145
   }
146
}
Copied!
You can try the API out at Swagger documentation page https://app.celly.ai/docs/lis​
⚙️ Configurations - Previous
Team management
Next - ⚙️ Configurations
Motorized stage
Last modified 2mo ago
Copy link