{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Checking the Status of an Import or Validation Job","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"checking-the-status-of-an-import-or-validation-job","__idx":0},"children":["Checking the Status of an Import or Validation Job"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This section explains how to check the real-time status and final results of a content import or validation job you have already started."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Since both import and validation operations are asynchronous, they run in the background. After you successfully initiate a job, you receive a unique ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["job_id"]},". You must use this ID to poll the status endpoint to track the job's progress from start to finish."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"prerequisites","__idx":1},"children":["Prerequisites"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A valid OAuth 2.0 access token with the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["knowledge.contentmgr.manage"]}," scope."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["job_id"]}," that was returned in the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location"]}," header of your initial ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /import/content"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /import/content/validate"]}," request."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"api-endpoint","__idx":2},"children":["API Endpoint"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To get the status of a specific job, you will make a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET"]}," request to the following endpoint, including the job's unique ID in the URL:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://${API_DOMAIN}/knowledge/contentmgr/v4/import/content/{job_id}/status"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"using-curl-to-check-job-status","__idx":3},"children":["Using cURL to Check Job Status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use the following ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cURL"]}," command to retrieve the job status. Remember to replace the placeholder values."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --location --request GET 'https://<API_DOMAIN>/knowledge/contentmgr/v4/import/content/<YOUR_JOB_ID>/status' \\\n--header 'Authorization: Bearer <YOUR_ACCESS_TOKEN>'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"placeholders-to-replace","__idx":4},"children":["Placeholders to Replace:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["<API_DOMAIN>:"]}," The domain of your API."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["<YOUR_JOB_ID>:"]}," The unique ID of the job you want to check."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["<YOUR_ACCESS_TOKEN>:"]}," Your OAuth 2.0 access token."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"understanding-the-status-response","__idx":5},"children":["Understanding the Status Response"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response will be a JSON object containing the current state and details of your job. The status field is the most important indicator."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"possible-status-values","__idx":6},"children":["Possible Status Values:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Scheduled:"]}," The job has been accepted and is waiting for its scheduled start time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["In Progress:"]}," The job is actively being processed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Successful:"]}," The job completed without critical errors."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Failed:"]}," The job stopped due to a critical error."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["Cancelled:"]}," The job was manually cancelled before it could complete."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-response-job-in-progress","__idx":7},"children":["Example Response: Job in Progress"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This shows a job that is currently running. The progress object indicates how much has been completed."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"status\": \"In Progress\",\n    \"jobType\": \"Import\",\n    \"progress\": {\n        \"processed\": 1250,\n        \"total\": 5000,\n        \"percentage\": 25\n    },\n    \"logFileLocation\": \"s3://mybucket/logs/import-logs-7A84B875-6F75-4C7B-B137-0632B62DB0BD.txt\",\n    \"startTime\": \"2024-03-01T10:00:00.000Z\",\n    \"estimatedCompletion\": \"2024-03-01T11:30:00.000Z\",\n    \"currentOperation\": \"Processing content items\"\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-response-successful-validation-job","__idx":8},"children":["Example Response: Successful Validation Job"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This shows a validation job that has finished successfully. The results object summarizes the findings. For any warnings or errors, you should consult the file at logFileLocation."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n    \"status\": \"Successful\",\n    \"jobType\": \"Validation\",\n    \"progress\": {\n        \"processed\": 5000,\n        \"total\": 5000,\n        \"percentage\": 100\n    },\n    \"logFileLocation\": \"s3://mybucket/logs/import-logs-7A84B875-6F75-4C7B-B137-0632B62DB0BD.txt\",\n    \"startTime\": \"2024-03-01T10:00:00.000Z\",\n    \"completionTime\": \"2024-03-01T11:15:00.000Z\",\n    \"results\": {\n        \"successful\": 4985,\n        \"warnings\": 10,\n        \"errors\": 5\n    }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"example-response-failed-job","__idx":9},"children":["Example Response: Failed Job"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This shows a job that failed during processing. The error field provides a high-level reason for the failure. More details will be available in the log file."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"{\n    \"status\": \"Failed\",\n    \"jobType\": \"Import\",\n    \"progress\": {\n        \"processed\": 1250,\n        \"total\": 5000,\n        \"percentage\": 25\n    },\n    \"logFileLocation\": \"s3://mybucket/logs/import-logs-7A84B875-6F75-4C7B-B137-0632B62DB0BD.txt\",\n    \"startTime\": \"2024-03-01T10:00:00.000Z\",\n    \"failureTime\": \"2024-03-01T10:45:00.000Z\",\n    \"error\": \"Database connection timeout after processing 1250 items\",\n    \"retryable\": true\n}\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Next Steps"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["If \"In Progress\":"]}," Continue to poll the status endpoint periodically until the status changes."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["If \"Successful\":"]}," Your job is complete. If it was a validation job with zero errors, you can now proceed with the actual content import."]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"b","attributes":{},"children":["If \"Failed\" or has \"errors\":"]}," Review the error message and download the log file from the logFileLocation to diagnose and fix the issues in your source content."]}]}]}]},"headings":[{"value":"Checking the Status of an Import or Validation Job","id":"checking-the-status-of-an-import-or-validation-job","depth":1},{"value":"Prerequisites","id":"prerequisites","depth":2},{"value":"API Endpoint","id":"api-endpoint","depth":2},{"value":"Using cURL to Check Job Status","id":"using-curl-to-check-job-status","depth":2},{"value":"Placeholders to Replace:","id":"placeholders-to-replace","depth":3},{"value":"Understanding the Status Response","id":"understanding-the-status-response","depth":3},{"value":"Possible Status Values:","id":"possible-status-values","depth":4},{"value":"Example Response: Job in Progress","id":"example-response-job-in-progress","depth":3},{"value":"Example Response: Successful Validation Job","id":"example-response-successful-validation-job","depth":3},{"value":"Example Response: Failed Job","id":"example-response-failed-job","depth":3}],"frontmatter":{"seo":{"title":"Checking the Status of an Import or Validation Job"}},"lastModified":"2026-03-23T19:46:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/developer-portal/guides/ingestion/ingestion-get-status-job","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}