--- updatedAt: 2026-08-27T12:37:17.000Z agentTools: projectIndex: https://developer.candis.io/llms.txt --- # Get Import Logs Returns Status Summary on Core data Import Request received | Request limit | Batch size | | -------------------------------------------------------------------------- | -------------- | | 500 requests per minute per organization
2,500 per minute per holding | Not applicable | Import status requests contain no records and are subject to the request limit only. [Rate Limiting Policy](/docs/rate-limiting-policy) # OpenAPI definition ```json { "openapi": "3.0.0", "paths": { "/v1/organizations/{organizationId}/imports/{processId}": { "get": { "description": "Returns Status Summary on Core data Import Request received", "operationId": "getImportLogs", "parameters": [ { "name": "organizationId", "required": true, "in": "path", "description": "The organization ID.", "schema": { "example": "alpha-organization", "type": "string" } }, { "name": "processId", "required": true, "in": "path", "description": "The import Request ID.", "schema": { "example": "9924bb4a-7ee9-4b6a-ac7b-30fdbe6b0031", "type": "string" } }, { "name": "offset", "required": false, "in": "query", "description": "The offset of the first element in the list.", "schema": { "minimum": 0, "default": 0, "example": 0, "type": "number" } }, { "name": "limit", "required": false, "in": "query", "description": "The maximum number of elements to return.", "schema": { "minimum": 1, "default": 50, "example": 50, "type": "number" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "jobStatus": { "type": "string", "description": "The status of the import job request.", "example": "PROCESSED", "enum": [ "PROCESSED", "PROCESSING" ] }, "events": { "description": "List of Import Logs.", "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "The unique identifier for the code data", "example": "ABC-000" }, "processId": { "type": "string", "description": "The unique identifier of the import request.", "example": "9924bb4a-7ee9-4b6a-ac7b-30fdbe6b0031" }, "organizationId": { "type": "string", "description": "The organization ID.", "example": "alpha-organization" }, "status": { "type": "string", "description": "The status of the core data entity import.", "example": "FAILED", "enum": [ "FAILED", "IMPORTED" ] }, "importErrors": { "type": "array", "description": "The Error encountered while trying to process the request.\n`ACCOUNT_CODE_ALREADY_EXIST` `ACCOUNT_CODE_NOT_EXISTING` `COST_CENTER_ALREADY_EXIST` `COST_CENTER_NOT_EXISTING` `BOOKING_KEY_ALREADY_EXIST` `BOOKING_KEY_NOT_FOUND` `CONTACT_ALREADY_EXIST` `CONTACT_NOT_EXISTING` `DUPLICATE_CONTACT_NAME` `NO_UPDATABLE_INPUT` `PAYMENT_CONDITION_ALREADY_EXIST` `PAYMENT_CONDITION_NOT_FOUND` `PAYMENT_CONDITION_IS_ARCHIVED` `UNKNOWN_ERROR` `INVALID_INPUT` `INVALID_TAX_NUMBER` `INVALID_IBAN`", "example": [ "ACCOUNT_CODE_ALREADY_EXIST" ], "items": { "type": "string", "enum": [ "ACCOUNT_CODE_ALREADY_EXIST", "ACCOUNT_CODE_NOT_EXISTING", "COST_CENTER_ALREADY_EXIST", "COST_CENTER_NOT_EXISTING", "BOOKING_KEY_ALREADY_EXIST", "BOOKING_KEY_NOT_FOUND", "CONTACT_ALREADY_EXIST", "CONTACT_NOT_EXISTING", "DUPLICATE_CONTACT_NAME", "NO_UPDATABLE_INPUT", "PAYMENT_CONDITION_ALREADY_EXIST", "PAYMENT_CONDITION_NOT_FOUND", "PAYMENT_CONDITION_IS_ARCHIVED", "UNKNOWN_ERROR", "INVALID_INPUT", "INVALID_TAX_NUMBER", "INVALID_IBAN" ] } }, "operation": { "type": "string", "description": "The import request operation", "example": "CREATE", "enum": [ "CREATE", "UPDATE" ] }, "createdAt": { "format": "date-time", "type": "string", "description": "The date and time when the import was processed.", "example": "2024-01-01T12:00:00Z" } }, "required": [ "id", "processId", "organizationId", "status", "operation", "createdAt" ] } }, "pagination": { "description": "Pagination Data providing information and the record count, page size and total count", "allOf": [ { "type": "object", "properties": { "pageCount": { "type": "number", "example": 10, "description": "This is the total number of pages available with records" }, "pageSize": { "type": "number", "example": 50, "description": "This is the length of size of the current page" }, "totalCount": { "type": "number", "example": 500, "description": "This is the total count of export records available" } }, "required": [ "pageCount", "pageSize", "totalCount" ] } ] } }, "required": [ "jobStatus", "events", "pagination" ] } } } }, "400": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "errorCode": { "type": "string", "description": "The Error Code assigned to the issue encountered", "enum": [ "UNAUTHORIZED", "FORBIDDEN", "BAD_REQUEST", "SERVICE_UNAVAILABLE", "INTERNAL_SERVER_ERROR", "MISSING_REQUESTER_ID", "BAD_INPUT", "NOT_FOUND", "EXPORTABLE_POSTINGS_NOT_FOUND", "TOO_MANY_REQUEST", "FAILED_TO_FETCH_DOWNLOAD_URL", "FILE_NOT_FOUND" ] }, "message": { "type": "string", "description": "Description about the issue encountered" }, "requestId": { "type": "string", "description": "This is the unique identifier for the request." }, "errors": { "description": "This is an optional output that can provide more details about the input parameters that may have caused an issue.", "type": "array", "items": { "type": "object", "properties": { "index": { "type": "string", "description": "This identifies the index of the payload that has an issue." }, "property": { "type": "string", "description": "This identifies the parameter that has an issue." }, "messages": { "description": "This provides more details about the parameter that has an issue.", "type": "array", "items": { "type": "string" } } }, "required": [ "property", "messages" ] } } }, "required": [ "errorCode", "message" ] } } } }, "429": { "description": "The request limit for this organization, or for its holding, has been exceeded.\n\nSee the [Rate Limiting Policy](https://developer.candis.io/docs/rate-limiting-policy) for the limits, response headers and retry guidance.", "headers": { "Retry-After": { "description": "Whole seconds to wait before retrying. See the Rate Limiting Policy for how the value is derived.", "schema": { "type": "integer", "example": 42 } } }, "content": { "application/json": { "schema": { "type": "object", "properties": { "errorCode": { "type": "string", "description": "The Error Code assigned to the issue encountered", "enum": [ "UNAUTHORIZED", "FORBIDDEN", "BAD_REQUEST", "SERVICE_UNAVAILABLE", "INTERNAL_SERVER_ERROR", "MISSING_REQUESTER_ID", "BAD_INPUT", "NOT_FOUND", "EXPORTABLE_POSTINGS_NOT_FOUND", "TOO_MANY_REQUEST", "FAILED_TO_FETCH_DOWNLOAD_URL", "FILE_NOT_FOUND" ] }, "message": { "type": "string", "description": "Description about the issue encountered" }, "requestId": { "type": "string", "description": "This is the unique identifier for the request." }, "limit": { "type": "string", "description": "Which limit rejected the request: the request limit, which counts requests, or the record limit, which meters the records in the request body.", "enum": [ "request", "record" ] }, "scope": { "type": "string", "description": "Whose allowance was exhausted: the organization’s own, or the shared allowance of the holding it belongs to.", "enum": [ "organization", "holding" ] } }, "required": [ "errorCode", "message" ] } } } }, "503": { "description": "", "content": { "application/json": { "schema": { "type": "object", "properties": { "errorCode": { "type": "string", "description": "The Error Code assigned to the issue encountered", "enum": [ "UNAUTHORIZED", "FORBIDDEN", "BAD_REQUEST", "SERVICE_UNAVAILABLE", "INTERNAL_SERVER_ERROR", "MISSING_REQUESTER_ID", "BAD_INPUT", "NOT_FOUND", "EXPORTABLE_POSTINGS_NOT_FOUND", "TOO_MANY_REQUEST", "FAILED_TO_FETCH_DOWNLOAD_URL", "FILE_NOT_FOUND" ] }, "message": { "type": "string", "description": "Description about the issue encountered" }, "requestId": { "type": "string", "description": "This is the unique identifier for the request." } }, "required": [ "errorCode", "message" ] } } } } }, "security": [ { "bearer": [] } ], "summary": "Get Import Logs", "tags": [ "Core Data" ] } } }, "info": { "title": "Candis API", "version": "1.0", "description": "", "contact": {}, "x-logo": { "url": "https://www.candis.io/img/candis-logo-black.svg", "altText": "Candis GmbH" } }, "servers": [ { "url": "https://api.candis.io" }, { "description": "Candis API Authorization Server.", "url": "https://id.my.candis.io/auth/realms/candis/protocol/openid-connect" } ], "components": { "securitySchemes": { "bearer": { "scheme": "bearer", "bearerFormat": "JWT", "type": "http" } } } } ```