> For the complete documentation index, see [llms.txt](https://developer.collibra.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.collibra.com/api/references/import/import-results.md).
# Import Results
Additional information about finished import jobs
## List the errors of a finished import job
> Returns a list of errors of a finished import job with the specified ID. By default the maximum number of results is limited to 1000.
```json
{"openapi":"3.0.3","info":{"title":"Collibra Import API","version":"2.0"},"tags":[{"name":"Import Results","description":"Additional information about finished import jobs"}],"servers":[{"url":"/rest/2.0","variables":{}}],"security":[{"basicAuth":[]},{"jwtAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Collibra REST API authentication using Basic Authentication.","scheme":"basic"},"jwtAuth":{"type":"http","description":"Collibra REST API authentication using JSON Web Token.","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ImportErrorPagedResponse":{"type":"object","properties":{"total":{"type":"integer","description":"The total number of results.","format":"int64"},"offset":{"type":"integer","description":"The offset for the results.","format":"int64"},"limit":{"type":"integer","description":"The maximum number of results to be returned.","format":"int64"},"results":{"type":"array","description":"The list of results.","items":{"$ref":"#/components/schemas/ImportError"}}}},"ImportError":{"type":"object","properties":{"errorType":{"type":"string","description":"Import error type.","enum":["VALIDATION","RUNTIME"]},"resourceType":{"type":"string","description":"Import resource type.","enum":["COMMUNITY","DOMAIN","ASSET","ATTRIBUTE","RELATION","COMPLEX_RELATION","MAPPING","RESPONSIBILITY"]},"errorMessage":{"type":"string","description":"User friendly error message."},"command":{"$ref":"#/components/schemas/ImportCommandReference"}},"description":"Import job error."},"ImportCommandReference":{"type":"object","properties":{"indices":{"type":"array","description":"A list of indices of the import command in the input file.","items":{"type":"integer","description":"A list of indices of the import command in the input file.","format":"int32"}},"identifier":{"type":"string","description":"Import command identifier."}},"description":"A reference to the import command."}}},"paths":{"/import/results/{jobId}/errors":{"get":{"tags":["Import Results"],"summary":"List the errors of a finished import job","description":"Returns a list of errors of a finished import job with the specified ID. By default the maximum number of results is limited to 1000.","operationId":"findImportErrors","parameters":[{"name":"jobId","in":"path","description":"The ID of the job","required":true,"schema":{"type":"string","format":"uuid"}},{"name":"offset","in":"query","description":"The first result to retrieve. If not set (offset = 0), results will be retrieved starting from row 0.","schema":{"type":"integer","format":"int32","default":0}},{"name":"limit","in":"query","description":"The maximum number of results to retrieve. If not set (limit = 0), the default limit will be used. The maximum allowed limit is 1000.","schema":{"type":"integer","format":"int32","default":0}},{"name":"countLimit","in":"query","description":"Allows to limit the number of elements that will be counted. -1 will count everything and 0 will cause the count to be skipped","schema":{"type":"integer","format":"int32","default":-1}}],"responses":{"200":{"description":"Import errors paged response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportErrorPagedResponse"}}}},"400":{"description":"Import job is not finished"},"404":{"description":"Import job not found"}}}}}}
```
## Retrieve a summary of a finished import job
> Returns details about a finished import job with the specified ID such as the total number of resources and types of resources that were added, removed or updated and the number of errors.
```json
{"openapi":"3.0.3","info":{"title":"Collibra Import API","version":"2.0"},"tags":[{"name":"Import Results","description":"Additional information about finished import jobs"}],"servers":[{"url":"/rest/2.0","variables":{}}],"security":[{"basicAuth":[]},{"jwtAuth":[]}],"components":{"securitySchemes":{"basicAuth":{"type":"http","description":"Collibra REST API authentication using Basic Authentication.","scheme":"basic"},"jwtAuth":{"type":"http","description":"Collibra REST API authentication using JSON Web Token.","scheme":"bearer","bearerFormat":"JWT"}},"schemas":{"ImportSummary":{"type":"object","properties":{"resourceTypes":{"type":"array","description":"A list of the resource type import summary.","items":{"$ref":"#/components/schemas/ResourceTypeSummary"}},"errorsCount":{"type":"integer","description":"The total number of errors the occurred during the import.","format":"int32"},"importJobState":{"type":"string","description":"Import job state.","enum":["COMPLETED","FAILED","COMPLETED_WITH_ERRORS","ABORTED"]}},"description":"A summary of the import."},"ResourceTypeSummary":{"type":"object","properties":{"resourceType":{"type":"string","description":"Import resource type.","enum":["COMMUNITY","DOMAIN","ASSET","ATTRIBUTE","RELATION","COMPLEX_RELATION","MAPPING","RESPONSIBILITY"]},"counters":{"$ref":"#/components/schemas/ImportCounters"},"subcategories":{"type":"array","description":"A detailed summary of the number of resources that have been affected by the import job. This can be empty for some resource types, f.e. Mapping.","items":{"$ref":"#/components/schemas/SubcategorySummary"}}},"description":"A summary of the import for a particular resource, for example Community, Domain or Asset."},"ImportCounters":{"type":"object","properties":{"added":{"type":"integer","description":"The number of added resources.","format":"int32"},"removed":{"type":"integer","description":"The number of removed resources.","format":"int32"},"updated":{"type":"integer","description":"The number of updated resources.","format":"int32"}},"description":"The number of added, removed or updated resources."},"SubcategorySummary":{"type":"object","properties":{"category":{"$ref":"#/components/schemas/CategoryReference"},"counters":{"$ref":"#/components/schemas/ImportCounters"}},"description":"A summary of the import for a particular type of resource, for example Physical Data Dictionary or Business Term."},"CategoryReference":{"type":"object","properties":{"id":{"type":"string","description":"The ID of the category.","format":"uuid"},"name":{"type":"string","description":"The name of the category."}},"description":"A reference to the type of resource, for example Physical Data Dictionary or Business Term."}}},"paths":{"/import/results/{jobId}/summary":{"get":{"tags":["Import Results"],"summary":"Retrieve a summary of a finished import job","description":"Returns details about a finished import job with the specified ID such as the total number of resources and types of resources that were added, removed or updated and the number of errors.","operationId":"getImportJobSummary","parameters":[{"name":"jobId","in":"path","description":"The ID of the job","required":true,"schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Import job summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ImportSummary"}}}},"400":{"description":"Import job is not finished"},"404":{"description":"Import job not found"}}}}}}
```
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://developer.collibra.com/api/references/import/import-results.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.