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

{
    "activityId": "5bfacece-4bca-41d5-a6e0-09370d1f5fe5",
    "state": "EXECUTION_COMPLETED",
    ……. (other parameters that can be ignored)
}

Validation Failure

HTTP Status Code: 200 OK

{
    "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.