# Get Ingestion Activity Status
### Request Method
GET
### Request URL
{{BASE_URL}}/ingestion/elt/activity/status/{{activity_id}}
### Request Headers
| Parameter | Data Type | Field Validations | Description |
| --------------------- | --------- | ----------------- | ---------------------------------------------------------------- |
| x-cleartax-auth-token | String | NA | Mandatory. Access token linked to the workspace and environment. |
### Request Path Params
| Parameter | Data Type | Field Validations | Description |
| ------------ | --------- | ----------------- | --------------------------------------------------- |
| activity\_id | String | NA | Mandatory. Ingestion Activity ID from previous API. |
### Request Query Params
There are no query parameters for this API.
### Request Body
There will be no request body for this API.
### Response Status Codes
| HTTP Status Code | Description |
| ---------------- | ------------ |
| 200 | OK |
| 400 | Bad request |
| 401 | Unauthorised |
| 403 | Forbidden |
### Response Schema
| Parameter | Data Type | Field Validations | Description |
| ---------- | --------- | ----------------- | ---------------------------------------------------------------- |
| activityId | String | NA | Ingestion activity ID that can be used to check status later. |
| state | String | NA | End state will be “EXECUTION\_COMPLETED” or “EXECUTION\_FAILURE” |
### Sample Request and Response
#### Sample Request
```
curl --location 'https://api-sandbox.clear.in/ingestion/elt/activity/status/5bfacece-4bca-41d5-a6e0-09370d1f5fe5' \
--header 'x-cleartax-auth-token: ' \
--data ''
```
#### Sample Response
**Ingestion Complete**
HTTP Status Code: 200 OK
{% code overflow="wrap" %}
```json
{
"activityId": "5bfacece-4bca-41d5-a6e0-09370d1f5fe5",
"state": "EXECUTION_COMPLETED",
……. (other parameters that can be ignored)
}
```
{% endcode %}
**Validation Failure**
HTTP Status Code: 200 OK
```json
{
"activityId": "9ddb39f3-66dd-49a6-931c-c66cf0bcc51f",
"state": "EXECUTION_COMPLETED",
"ingestionActivities": [
{
"externalId": null,
"activityId": "5e8b058484a4454fb76787dafd409dab",
"state": "SYSTEM_FEEDBACK",
"status": "FAILURE",
"templateType": "GENERAL_LEDGER",
"tenant": "GENERALLEDGER",
"mode": "gl-iceberg",
"processingStats": [],
"errorFileUrl": null
},
{
"externalId": null,
"activityId": "a8be6155f70b4941b269afee36078f06",
"state": "SYSTEM_FEEDBACK",
"status": "FAILURE",
"templateType": "PURCHASE",
"tenant": "MaxItc",
"mode": "purchase",
"processingStats": [],
"errorFileUrl": null
},
{
"externalId": null,
"activityId": "b0a3215fd9ce4faeac3fee188b8632f0",
"state": "ACTIVITY_COMPLETED",
"status": "FAILURE",
"templateType": "SALES",
"tenant": "GSTSALES",
"mode": "sales",
"processingStats": [
{
"gstin": "29AAFCD5862R1ZR_CT",
"totalDocumentCount": 1,
"validRows": 0,
"invalidRows": 1,
"validDocuments": 0,
"invalidDocuments": 1
},
{
"gstin": "29AAFCD5862R000",
"totalDocumentCount": 1,
"validRows": 0,
"invalidRows": 1,
"validDocuments": 0,
"invalidDocuments": 1
}
],
"errorFileUrl": null
},
{
"externalId": null,
"activityId": "144c3ee3de0944f99a6060ca651b93ed",
"state": "SYSTEM_FEEDBACK",
"status": "FAILURE",
"templateType": "TDSV2_PR",
"tenant": "TDSV2PR",
"mode": "tds",
"processingStats": [],
"errorFileUrl": null
}
],
"processingStats": [
{
"gstin": "29AAFCD5862R1ZR_CT",
"totalDocumentCount": 1,
"validRows": 0,
"invalidRows": 1,
"validDocuments": 0,
"invalidDocuments": 1
},
{
"gstin": "29AAFCD5862R000",
"totalDocumentCount": 1,
"validRows": 0,
"invalidRows": 1,
"validDocuments": 0,
"invalidDocuments": 1
}
],
"errorFiles": [
{
"templateType": "GENERAL_LEDGER",
"errorFileUrl": "https://storage.clear.in/v1/ap-south-1/ingestionv2-prod/advance_ingestion/9ddb39f3-66dd-49a6-931c-c66cf0bcc51f/output/GENERAL_LEDGER/errors/GENERAL_LEDGER_error.zip?response-content-disposition=attachment%3B%20filename%3D%22GENERAL_LEDGER.zip%22&X-Amz-Security-Token=IQoJb3JpZ2luX2VjENn%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCmFwLXNvdXRoLTEiRzBFAiEAtU48hqnNIhSl3PtZBqc8qxFx2vt61B%2F9ZEqpRcvzb64CIC3eXSaw0EnK5crRGLybGtBqgTp0UR5CSV9EDJgo77VXKooFCKL%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEQBhoMMjE5MzQxOTA3OTgzIgyKCnS5qMjR25yftdsq3gQdBJZKjtyzhMD29EmOaa7E9TlHosigIEGv0RKSe5Uq6mKOnDT9WBiqc4083TbLyPsZ3oWtqQGqhsVRgBbweVtOJZ7FWK9oBhjkQJ%2Bi%2BC8dgE9%2B58TwhNsA3q%2FudqHCaM3Abs1fpZUwyA6c1t93NsubIocv0ZwaPYKfz89SLQdoayDRV7JQTyQNYqeVKNw%2BN1dvf6jyw%2B8acJnpIZSZQPamch%2B5eUsn406Dab1TMtVsNV%2BIL7pgdWK7YsbRWbFyXHuLc%2B4fEuwnQeie4l230Hv1fmcwxbfnGLl7Ewn%2Brl1r7NGGZ24b2nNZlALSk1%2BW%2F4TAT8QVjN%2B9%2FNsNNltxnEyp137Vj%2FCFNgOJ%2BKcTdqOpjik7fTZvbQPfI%2FkmXoYa3danieZOu2uuLql07OhDteFoCeZvLm33E%2Bff%2B6flbaQxDDpXddV8EU%2FiuAiL5Bot4xQpA3I7hyg6nBMt2ERdAbv%2F%2B8Vh6RFYxqvyNITXgPwtkyEZsR6ZbIN8qSvd0rJSuipUBQwVDxuD0YgLyyNg0Yw%2FU6C5iqJ6TNiEFnKmGCoAwXyt6LuKsAy3a1Q6hc8cUjLJf1kacz3gNsOieQalArvWToQZqb81zbF7RpUAfSBalH%2B44XuP0d2318ZSNTJ6Ahobr%2Ftw3a%2B4cwjL4%2B1y%2BtfhKctOlajL9M6iBsAf0kzzpKEwHnXCzdR6DjdSiqB4KnCsOw6GH%2BNQE1l1ugtdPdj%2FCmWrmx6cXWg1%2Bjf4pcl0aifFJkHoerTtI%2Bz6qPcjml9QutYAM1rmSaPPo58vIoUoEcfKsjtBKz78VO%2FGjgQwt6TayQY6mAFTCMCcCaSqLcbCR%2FXXbFo80aUnINTpeciDncVdFtox3o5kWhckvqsEGldJQk21obg44hhREnzruz%2BXw05YpNB6l%2BLjweUulw%2Bf9SSclak3D1Ih%2B%2FPwbXAcYH47qEdvDwHw99GVe3BXBUL4du0mili5QSkaFczEHAZ6pKe2pQN6PY6LqEju7CdGd0XkPtT5tNyr7rKm4EqKww%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20251208T090338Z&X-Amz-SignedHeaders=host&X-Amz-Expires=36000&X-Amz-Credential=ASIATGEOL5AHT2YH2OYS%2F20251208%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Signature=4ada12f21bc1ac399d79e9635408caf491e827632643c4b6e911855cd17276b5"
},
{
"templateType": "PURCHASE",
"errorFileUrl": "https://storage.clear.in/v1/ap-south-1/ingestionv2-prod/advance_ingestion/9ddb39f3-66dd-49a6-931c-c66cf0bcc51f/output/PURCHASE/errors/PURCHASE_error.zip?response-content-disposition=attachment%3B%20filename%3D%22PURCHASE.zip%22&X-Amz-Security-Token=IQoJb3JpZ2luX2VjENn%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCmFwLXNvdXRoLTEiRzBFAiEAtU48hqnNIhSl3PtZBqc8qxFx2vt61B%2F9ZEqpRcvzb64CIC3eXSaw0EnK5crRGLybGtBqgTp0UR5CSV9EDJgo77VXKooFCKL%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEQBhoMMjE5MzQxOTA3OTgzIgyKCnS5qMjR25yftdsq3gQdBJZKjtyzhMD29EmOaa7E9TlHosigIEGv0RKSe5Uq6mKOnDT9WBiqc4083TbLyPsZ3oWtqQGqhsVRgBbweVtOJZ7FWK9oBhjkQJ%2Bi%2BC8dgE9%2B58TwhNsA3q%2FudqHCaM3Abs1fpZUwyA6c1t93NsubIocv0ZwaPYKfz89SLQdoayDRV7JQTyQNYqeVKNw%2BN1dvf6jyw%2B8acJnpIZSZQPamch%2B5eUsn406Dab1TMtVsNV%2BIL7pgdWK7YsbRWbFyXHuLc%2B4fEuwnQeie4l230Hv1fmcwxbfnGLl7Ewn%2Brl1r7NGGZ24b2nNZlALSk1%2BW%2F4TAT8QVjN%2B9%2FNsNNltxnEyp137Vj%2FCFNgOJ%2BKcTdqOpjik7fTZvbQPfI%2FkmXoYa3danieZOu2uuLql07OhDteFoCeZvLm33E%2Bff%2B6flbaQxDDpXddV8EU%2FiuAiL5Bot4xQpA3I7hyg6nBMt2ERdAbv%2F%2B8Vh6RFYxqvyNITXgPwtkyEZsR6ZbIN8qSvd0rJSuipUBQwVDxuD0YgLyyNg0Yw%2FU6C5iqJ6TNiEFnKmGCoAwXyt6LuKsAy3a1Q6hc8cUjLJf1kacz3gNsOieQalArvWToQZqb81zbF7RpUAfSBalH%2B44XuP0d2318ZSNTJ6Ahobr%2Ftw3a%2B4cwjL4%2B1y%2BtfhKctOlajL9M6iBsAf0kzzpKEwHnXCzdR6DjdSiqB4KnCsOw6GH%2BNQE1l1ugtdPdj%2FCmWrmx6cXWg1%2Bjf4pcl0aifFJkHoerTtI%2Bz6qPcjml9QutYAM1rmSaPPo58vIoUoEcfKsjtBKz78VO%2FGjgQwt6TayQY6mAFTCMCcCaSqLcbCR%2FXXbFo80aUnINTpeciDncVdFtox3o5kWhckvqsEGldJQk21obg44hhREnzruz%2BXw05YpNB6l%2BLjweUulw%2Bf9SSclak3D1Ih%2B%2FPwbXAcYH47qEdvDwHw99GVe3BXBUL4du0mili5QSkaFczEHAZ6pKe2pQN6PY6LqEju7CdGd0XkPtT5tNyr7rKm4EqKww%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20251208T090338Z&X-Amz-SignedHeaders=host&X-Amz-Expires=36000&X-Amz-Credential=ASIATGEOL5AHT2YH2OYS%2F20251208%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Signature=03f5b75557b6b24ffe1f7f62c4dbe1adb5dee73dfcef39346afdc82b15ed9e9f"
},
{
"templateType": "SALES",
"errorFileUrl": "https://storage.clear.in/v1/ap-south-1/ingestionv2-prod/advance_ingestion/9ddb39f3-66dd-49a6-931c-c66cf0bcc51f/output/SALES/errors/SALES_error.zip?response-content-disposition=attachment%3B%20filename%3D%22SALES.zip%22&X-Amz-Security-Token=IQoJb3JpZ2luX2VjENn%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCmFwLXNvdXRoLTEiRzBFAiEAtU48hqnNIhSl3PtZBqc8qxFx2vt61B%2F9ZEqpRcvzb64CIC3eXSaw0EnK5crRGLybGtBqgTp0UR5CSV9EDJgo77VXKooFCKL%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEQBhoMMjE5MzQxOTA3OTgzIgyKCnS5qMjR25yftdsq3gQdBJZKjtyzhMD29EmOaa7E9TlHosigIEGv0RKSe5Uq6mKOnDT9WBiqc4083TbLyPsZ3oWtqQGqhsVRgBbweVtOJZ7FWK9oBhjkQJ%2Bi%2BC8dgE9%2B58TwhNsA3q%2FudqHCaM3Abs1fpZUwyA6c1t93NsubIocv0ZwaPYKfz89SLQdoayDRV7JQTyQNYqeVKNw%2BN1dvf6jyw%2B8acJnpIZSZQPamch%2B5eUsn406Dab1TMtVsNV%2BIL7pgdWK7YsbRWbFyXHuLc%2B4fEuwnQeie4l230Hv1fmcwxbfnGLl7Ewn%2Brl1r7NGGZ24b2nNZlALSk1%2BW%2F4TAT8QVjN%2B9%2FNsNNltxnEyp137Vj%2FCFNgOJ%2BKcTdqOpjik7fTZvbQPfI%2FkmXoYa3danieZOu2uuLql07OhDteFoCeZvLm33E%2Bff%2B6flbaQxDDpXddV8EU%2FiuAiL5Bot4xQpA3I7hyg6nBMt2ERdAbv%2F%2B8Vh6RFYxqvyNITXgPwtkyEZsR6ZbIN8qSvd0rJSuipUBQwVDxuD0YgLyyNg0Yw%2FU6C5iqJ6TNiEFnKmGCoAwXyt6LuKsAy3a1Q6hc8cUjLJf1kacz3gNsOieQalArvWToQZqb81zbF7RpUAfSBalH%2B44XuP0d2318ZSNTJ6Ahobr%2Ftw3a%2B4cwjL4%2B1y%2BtfhKctOlajL9M6iBsAf0kzzpKEwHnXCzdR6DjdSiqB4KnCsOw6GH%2BNQE1l1ugtdPdj%2FCmWrmx6cXWg1%2Bjf4pcl0aifFJkHoerTtI%2Bz6qPcjml9QutYAM1rmSaPPo58vIoUoEcfKsjtBKz78VO%2FGjgQwt6TayQY6mAFTCMCcCaSqLcbCR%2FXXbFo80aUnINTpeciDncVdFtox3o5kWhckvqsEGldJQk21obg44hhREnzruz%2BXw05YpNB6l%2BLjweUulw%2Bf9SSclak3D1Ih%2B%2FPwbXAcYH47qEdvDwHw99GVe3BXBUL4du0mili5QSkaFczEHAZ6pKe2pQN6PY6LqEju7CdGd0XkPtT5tNyr7rKm4EqKww%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20251208T090338Z&X-Amz-SignedHeaders=host&X-Amz-Expires=36000&X-Amz-Credential=ASIATGEOL5AHT2YH2OYS%2F20251208%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Signature=a327e98b3d165f22e4f5638ffb536db793400cdf83caae71fa5d87636a47a9cf"
},
{
"templateType": "TDSV2_PR",
"errorFileUrl": "https://storage.clear.in/v1/ap-south-1/ingestionv2-prod/advance_ingestion/9ddb39f3-66dd-49a6-931c-c66cf0bcc51f/output/TDSV2_PR/errors/TDSV2_PR_error.zip?response-content-disposition=attachment%3B%20filename%3D%22TDSV2_PR.zip%22&X-Amz-Security-Token=IQoJb3JpZ2luX2VjENn%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCmFwLXNvdXRoLTEiRzBFAiEAtU48hqnNIhSl3PtZBqc8qxFx2vt61B%2F9ZEqpRcvzb64CIC3eXSaw0EnK5crRGLybGtBqgTp0UR5CSV9EDJgo77VXKooFCKL%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEQBhoMMjE5MzQxOTA3OTgzIgyKCnS5qMjR25yftdsq3gQdBJZKjtyzhMD29EmOaa7E9TlHosigIEGv0RKSe5Uq6mKOnDT9WBiqc4083TbLyPsZ3oWtqQGqhsVRgBbweVtOJZ7FWK9oBhjkQJ%2Bi%2BC8dgE9%2B58TwhNsA3q%2FudqHCaM3Abs1fpZUwyA6c1t93NsubIocv0ZwaPYKfz89SLQdoayDRV7JQTyQNYqeVKNw%2BN1dvf6jyw%2B8acJnpIZSZQPamch%2B5eUsn406Dab1TMtVsNV%2BIL7pgdWK7YsbRWbFyXHuLc%2B4fEuwnQeie4l230Hv1fmcwxbfnGLl7Ewn%2Brl1r7NGGZ24b2nNZlALSk1%2BW%2F4TAT8QVjN%2B9%2FNsNNltxnEyp137Vj%2FCFNgOJ%2BKcTdqOpjik7fTZvbQPfI%2FkmXoYa3danieZOu2uuLql07OhDteFoCeZvLm33E%2Bff%2B6flbaQxDDpXddV8EU%2FiuAiL5Bot4xQpA3I7hyg6nBMt2ERdAbv%2F%2B8Vh6RFYxqvyNITXgPwtkyEZsR6ZbIN8qSvd0rJSuipUBQwVDxuD0YgLyyNg0Yw%2FU6C5iqJ6TNiEFnKmGCoAwXyt6LuKsAy3a1Q6hc8cUjLJf1kacz3gNsOieQalArvWToQZqb81zbF7RpUAfSBalH%2B44XuP0d2318ZSNTJ6Ahobr%2Ftw3a%2B4cwjL4%2B1y%2BtfhKctOlajL9M6iBsAf0kzzpKEwHnXCzdR6DjdSiqB4KnCsOw6GH%2BNQE1l1ugtdPdj%2FCmWrmx6cXWg1%2Bjf4pcl0aifFJkHoerTtI%2Bz6qPcjml9QutYAM1rmSaPPo58vIoUoEcfKsjtBKz78VO%2FGjgQwt6TayQY6mAFTCMCcCaSqLcbCR%2FXXbFo80aUnINTpeciDncVdFtox3o5kWhckvqsEGldJQk21obg44hhREnzruz%2BXw05YpNB6l%2BLjweUulw%2Bf9SSclak3D1Ih%2B%2FPwbXAcYH47qEdvDwHw99GVe3BXBUL4du0mili5QSkaFczEHAZ6pKe2pQN6PY6LqEju7CdGd0XkPtT5tNyr7rKm4EqKww%3D%3D&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20251208T090338Z&X-Amz-SignedHeaders=host&X-Amz-Expires=35999&X-Amz-Credential=ASIATGEOL5AHT2YH2OYS%2F20251208%2Fap-south-1%2Fs3%2Faws4_request&X-Amz-Signature=aa22d87e549fb24ea709d1a5482633a50cbcb5f2bca76f024549ffb73dcfc603"
}
],
"reportFiles": []
}
```
### API Validations
Currently there are no known validations.
### API Constraints
1. There can be multiple intermediate states. It may take 10-15 mins for an activity to complete based on the size of the files uploaded that need to be processed. Further if there is any error, it will be retried thrice before reaching the end state.
2. Use exponential intervals for polling status.