Get a run result

GET

/spaces/:spaceId/runs/:runId/result

GET

/spaces/:spaceId/runs/:runId/result

$ curl https://api.cloudraker.com/spaces/spaceId/runs/runId/result \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

200Retrieved

1 {
2   "version": 1,
3   "runId": "a3f47b2e-9c4d-4f1a-8b2e-3d5f7a9c1234",
4   "actionSlug": "invoice_extraction",
5   "unit": "per_document",
6   "fieldKeys": [
7     "invoice_number",
8     "date",
9     "total_amount"
10   ],
11   "schema": {
12     "invoice_number": {
13       "type": "string",
14       "description": "Unique identifier for the invoice"
15     },
16     "date": {
17       "type": "string",
18       "format": "date",
19       "description": "Date of the invoice"
20     },
21     "total_amount": {
22       "type": "number",
23       "description": "Total amount due on the invoice"
24     }
25   },
26   "docs": [
27     {
28       "id": "file_987654321",
29       "name": "Invoice_2024_01_10.pdf",
30       "contentType": "application/pdf",
31       "status": "done",
32       "error": "",
33       "data": {
34         "invoice_number": "INV-20240110-001",
35         "date": "2024-01-10",
36         "total_amount": 1250.75
37       },
38       "evidence": {
39         "invoice_number": [
40           {
41             "fileId": "file_987654321",
42             "page": 1,
43             "bbox": [
44               100,
45               200,
46               300,
47               220
48             ]
49           }
50         ],
51         "date": [
52           {
53             "fileId": "file_987654321",
54             "page": 1,
55             "bbox": [
56               100,
57               230,
58               200,
59               250
60             ]
61           }
62         ],
63         "total_amount": [
64           {
65             "fileId": "file_987654321",
66             "page": 1,
67             "bbox": [
68               400,
69               600,
70               500,
71               620
72             ]
73           }
74         ]
75       },
76       "rows": [
77         {
78           "data": {
79             "item": "Widget A",
80             "quantity": 10,
81             "price": 25.5
82           },
83           "evidence": {
84             "item": [
85               {
86                 "fileId": "file_987654321",
87                 "page": 2,
88                 "bbox": [
89                   50,
90                   100,
91                   150,
92                   120
93                 ]
94               }
95             ],
96             "quantity": [
97               {
98                 "fileId": "file_987654321",
99                 "page": 2,
100                 "bbox": [
101                   160,
102                   100,
103                   200,
104                   120
105                 ]
106               }
107             ],
108             "price": [
109               {
110                 "fileId": "file_987654321",
111                 "page": 2,
112                 "bbox": [
113                   210,
114                   100,
115                   260,
116                   120
117                 ]
118               }
119             ]
120           }
121         }
122       ],
123       "edited": true
124     }
125   ],
126   "createdAt": "2024-01-15T09:30:00Z",
127   "finishedAt": "2024-01-15T09:45:00Z",
128   "evidenceOmitted": true,
129   "dataOmitted": true
130 }

Fetches the durable, grounded result of a terminal extract-structured run: one entry per source document with extracted data, per-field evidence (source citations), envelope (unit, fieldKeys, schema) and per-document status. Requires space:read (denied → 404, which also hides the space’s existence). Returns 404 while the run is still running or when no result exists. Response status and headers are preserved.

Fetches the durable, grounded result of a terminal extract-structured run: one entry per source document with extracted `data`, per-field `evidence` (source citations), envelope (`unit`, `fieldKeys`, `schema`) and per-document status. Requires `space:read` (denied → 404, which also hides the space's existence). Returns 404 while the run is still `running` or when no result exists. Response status and headers are preserved.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

spaceIdstringRequired

runIdstringRequired

Response

The durable, grounded run result.

versioninteger-9007199254740991-9007199254740991

runIdstring

actionSlugstring

unitenum

fieldKeyslist of strings

schemamap from strings to any or null

The applied (or inferred) extraction schema.

docslist of objects

createdAtdatetime

finishedAtdatetime or null

evidenceOmittedtrue

The size guard dropped the citations.

dataOmittedtrue

The size guard dropped the values too.