> For the complete documentation index, see [llms.txt](https://klearstack.gitbook.io/klearstack-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://klearstack.gitbook.io/klearstack-api-documentation/fetch-documents/get-extracted-results-for-invoices-in-between-date-range.md).

# Get Extracted Results For Invoices In Between Date Range

Endpoint Name: getdocumentsbetweendates

Request type : `POST`

Authorization : Bearer token as header

Endpoint Details : API is used to get the extracted data/results for invoices that belong to a specific date range.

## Request Type

<table data-header-hidden><thead><tr><th width="109"></th><th></th></tr></thead><tbody><tr><td>Method</td><td>URL</td></tr><tr><td>POST</td><td><code>URL/access/klearstack/getdocumentsbetweendates</code></td></tr></tbody></table>

## Request Body

<table data-header-hidden><thead><tr><th width="167"></th><th width="152"></th><th width="93.90911865234375"></th><th></th></tr></thead><tbody><tr><td>Params</td><td>Values</td><td>Required</td><td>Description</td></tr><tr><td>company_name</td><td>string</td><td>Yes</td><td>Name of the company.</td></tr><tr><td>collection_name</td><td>string</td><td>Yes</td><td>Name of the collection.</td></tr><tr><td>start_date</td><td>string</td><td>Yes</td><td>Format : “DD-MM-YYYY”.</td></tr><tr><td>end_date</td><td>string</td><td>Yes</td><td>Format : “DD-MM-YYYY”.</td></tr><tr><td>page_index</td><td>integer</td><td>No</td><td>integer value, Page number.</td></tr><tr><td>items_per_page</td><td>integer</td><td>No</td><td>Results per page (Max 20).</td></tr></tbody></table>

## Request Code Samples

### Shell

* Request Body

```sh
curl --location "URL/access/klearstack/getdocumentsbetweendates" \
  -H "Authorization: Bearer your_token_here" \
  --form "company_name=Replace_Company_Name_Here" \
  --form "collection_name=Replace_Collection_Name_Here"
  --form "start_date=DD-MM-YYYY" \
  --form "end_date=DD-MM-YYYY" \
  --form "page_index=1" \
  --form "items_per_page=10"
```

### Python

* Request Body

```python
import requests

url = "URL/access/klearstack/getdocumentsbetweendates"

payload = {'company_name': 'Replace_Company_Name_Here',
'collection_name': 'Replace_Collection_Name_Here'
'start_date': 'DD-MM-YYYY',
'end_date': 'DD-MM-YYYY',
'page_index': '1',
'items_per_page': '10'}
files=[

]
headers = {
  'Authorization': 'Bearer your_token_here'
}

response = requests.request("POST", url, headers=headers, data=payload, files=files)

print(response.text)

```

### Java (OkHttp)

* Request Body

```java
OkHttpClient client = new OkHttpClient();

RequestBody body = new MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart("company_name", "Replace_Company_Name_Here")
    .addFormDataPart("collection_name", "Replace_Collection_Name_Here")
    .addFormDataPart("start_date", "DD-MM-YYYY")
    .addFormDataPart("end_date", "DD-MM-YYYY")
    .addFormDataPart("page_index", "1")
    .addFormDataPart("items_per_page", "10")
    .build();

Request request = new Request.Builder()
    .url("URL/access/klearstack/getdocumentsbetweendates")
    .post(body)
    .addHeader("Authorization", "Bearer your_token_here")
    .build();

Response response = client.newCall(request).execute();
```

### Node.js (Axios)

* Request Body

```javascript
const axios = require('axios');
const FormData = require('form-data');

let formData = new FormData();
formData.append('company_name', 'Replace_Company_Name_Here');
formData.append('collection_name', 'Replace_Collection_Name_Here');
formData.append('start_date', 'DD-MM-YYYY');
formData.append('end_date', 'DD-MM-YYYY');
formData.append('page_index', '1');
formData.append('items_per_page', '10');

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'URL/access/klearstack/getdocumentsbetweendates',
  headers: {
    'Authorization': 'Bearer your_token_here',
    ...formData.getHeaders()
  },
  data: formData
};

axios.request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

```

### JavaScript (XHR)

* Request Body

```javascript
// WARNING: For POST requests, body is set to null by browsers.

var formData = new FormData();
formData.append("company_name", "Replace_Company_Name_Here");
formData.append("collection_name", "Replace_Collection_Name_Here");
formData.append("start_date", "DD-MM-YYYY");
formData.append("end_date", "DD-MM-YYYY");
formData.append("page_index", "1");
formData.append("items_per_page", "10");

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function() {
  if(this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("POST", "URL/access/klearstack/getdocumentsbetweendates");
xhr.setRequestHeader("Authorization", "Bearer your_token_here");

xhr.send(formData);
```

### API Response

<table><thead><tr><th></th><th></th></tr></thead><tbody><tr><td>Status Code</td><td>Response</td></tr><tr><td>200</td><td><pre><code>{
    "result": [
        {
            "Document_id": "68becd0f7cd9ff12c3d707d3",
            "is_approved": 0,
            "file_name": "test__MNV__9503222207.pdf",
            "overall_confidence": 0.8882295802918684,
            "document_type": "Invoice",
            "upload_time": "2025-09-08T18:03:21.001",
            "finished_time": "2025-09-08T18:04:47.017",
            "Inv_Number": {
                "value": "IA194485094",
                "confidence": 0.997040534621632,
                "page_index": 1,
                "coordinate": [
                    564,
                    557,
                    632,
                    566
                ]
            },
            "Inv_PO": {
                "value": "1146965",
                "confidence": 0.945120326753658,
                "page_index": 1,
                "coordinate": [
                    605,
                    271,
                    652,
                    280
                ]
            },
            "Engine_Number": {
                "value": "E20ASE09941",
                "confidence": 0.932500680264945,
                "page_index": 1,
                "coordinate": [
                    161,
                    883,
                    231,
                    891
                ]
            },
            "Chassis_Number": {
                "value": "MD2C59202SAE86580",
                "confidence": 0.931441079866287,
                "page_index": 1,
                "coordinate": [
                    413,
                    883,
                    527,
                    891
                ]
            },
            "Inv_Total": {
                "value": "100000.0",
                "confidence": 0.99,
                "page_index": 1,
                "coordinate": [
                    149,
                    1294,
                    162,
                    1304
                ]
            },
            "Inv_Supplier": {
                "value": "Digit Go Digit General Insurance Ltd",
                "page_index": 1,
                "coordinate": [
                    971,
                    68,
                    1161,
                    98
                ],
                "confidence": 0.75
            },
            "Inv_Customer": {
                "value": "PANKAJ SANTOSH RAUT",
                "page_index": 1,
                "coordinate": [
                    161,
                    234,
                    294,
                    246
                ],
                "confidence": 0.75
            },
            "Inv_Origin": {
                "value": "India",
                "confidence": 0.955733651465401,
                "page_index": 1,
                "coordinate": [
                    1244,
                    1110,
                    1269,
                    1120
                ]
            },
            "Inv_Customer_Mobile": {
                "value": "1111111111",
                "confidence": 0.954875597510902,
                "page_index": 1,
                "coordinate": [
                    0,
                    0,
                    0,
                    0
                ]
            },
            "Inv_Customer_Address": {
                "value": "HOSPITAL TEACHERS COLONY NHAVARA PO   1146965  NHAVARE  DIST : PUNE - 412211",
                "page_index": 1,
                "coordinate": [
                    263,
                    234,
                    513,
                    631
                ],
                "confidence": 0.94
            },
            "Inv_Date": {
                "value": "06-Aug-2025",
                "confidence": 0.9957775219021949,
                "page_index": 1,
                "coordinate": [
                    669,
                    560,
                    732,
                    568
                ]
            },
            "Sign_Exist_Flag": {
                "value": "True",
                "confidence": 0.5162655711174011,
                "page_index": 1,
                "coordinate": [
                    285,
                    366,
                    346,
                    417
                ]
            }
        }
    ],
    "status": "complete",
    "page_index": 1,
    "total_pages": 1,
    "total_count": 1
}
</code></pre></td></tr><tr><td>403</td><td>Forbidden: Client Error</td></tr><tr><td>501</td><td>Server Error</td></tr></tbody></table>
