> ## Documentation Index
> Fetch the complete documentation index at: https://venator-06aff335.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
# Document Extraction
Extract structured data from documents using AI-powered OCR and layout understanding. Supports multi-page documents and returns page-level extracted fields, classification, and confidence scores.
POST
/api/gw/services/document\_extraction
***
### Authorizations
API key used to authenticate requests.
***
### Body
Base64 encoded document image or file.
Original filename of the document.
***
### Response
Indicates whether the request was processed successfully.
Unique identifier for the API request.
Identifier used for tracing the request across systems.
Contains OCR processing results and metadata.
Total number of processed pages.
Total OCR processing time in milliseconds.
Identifier for stored artifacts/results.
List of extracted page-level results.
Index of the processed page.
Processing status of the page (e.g., SUCCESS, FAILED).
Detected document type (e.g., INVOICE).
Document side processed (e.g., FRONT, BACK).
Key-value pairs of extracted fields (e.g., invoice\_number, total\_amount).
Confidence score for the extracted data (0 to 1).
List of warnings encountered during processing.
Base64 or reference string for the processed page image.
Reason for failure if processing was not successful.
Contains error details if the request fails; otherwise null.
Time taken to process the request in milliseconds.
Timestamp when the request was processed (ISO 8601 format).
***
```bash Curl theme={null}
curl -X POST "https://dev-idf-gw.cognetlabs.org/api/gw/services/document_extraction" \
-H "Content-Type: application/json" \
-d '{
"imageBase64": "",
"filename": "invoice.pdf"
}'
```
```python Python theme={null}
import requests
url = "https://dev-idf-gw.cognetlabs.org/api/gw/services/document_extraction"
payload = {
"imageBase64": "",
"filename": "invoice.pdf"
}
print(requests.post(url, json=payload).json())
```
```javascript JavaScript theme={null}
fetch("https://dev-idf-gw.cognetlabs.org/api/gw/services/document_extraction", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
imageBase64: "",
filename: "invoice.pdf"
})
})
.then(res => res.json())
.then(console.log);
```
```php PHP theme={null}
"",
"filename" => "invoice.pdf"
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
```
```go Go theme={null}
package main
import (
"bytes"
"net/http"
)
func main() {
json := []byte(`{
"imageBase64":"",
"filename":"invoice.pdf"
}`)
http.Post(
"https://dev-idf-gw.cognetlabs.org/api/gw/services/document_extraction",
"application/json",
bytes.NewBuffer(json),
)
}
```
```java Java theme={null}
import okhttp3.*;
public class Main {
public static void main(String[] args) throws Exception {
OkHttpClient client = new OkHttpClient();
String json = "{\"imageBase64\":\"\", \"filename\":\"invoice.pdf\" }";
RequestBody body = RequestBody.create(json, MediaType.parse("application/json"));
Request request = new Request.Builder()
.url("https://dev-idf-gw.cognetlabs.org/api/gw/services/document_extraction")
.post(body)
.build();
Response response = client.newCall(request).execute();
System.out.println(response.body().string());
}
}
```
```ruby Ruby theme={null}
require 'net/http'
require 'uri'
require 'json'
uri = URI("https://dev-idf-gw.cognetlabs.org/api/gw/services/document_extraction")
payload = {
imageBase64: "",
filename: "invoice.pdf"
}
http = Net::HTTP.new(uri.host, uri.port)
request = Net::HTTP::Post.new(uri, {'Content-Type': 'application/json'})
request.body = payload.to_json
response = http.request(request)
puts response.body
```
```json 200 theme={null}
{
"success":true,
"requestId":"909ca3d2fe34",
"correlationId":"3f1b300063d94ed9a4ea4460a5656c2c",
"data":{
"pages":1,
"ocrTotalMs":320,
"artifactsId":"art_12345",
"results":[
{
"pageIndex":0,
"status":"SUCCESS",
"docType":"INVOICE",
"docSide":"FRONT",
"fields":{
"invoice_number":"12345",
"total_amount":"450.00"
},
"confidence":0.95,
"warnings":[
"string",
"string"
],
"pageImages":"string"
}
],
"failureReason":"string"
},
"error":null,
"durationMs":274,
"processedAt":"2026-04-29T13:58:18.7342517Z"
}
```
```json 400 theme={null}
{
"error": "ImageBase64 is required"
}
```