---
updatedAt: 2026-05-29T09:37:18.000Z
agentTools:
projectIndex: https://docs.talkdesk.com/llms.txt
---
# Get schedule import status and error report URL
Retrieves the current status of a schedule event import. Use this endpoint to poll for import completion after submitting a bulk import request.
When status is IMPORTED_WITH_ERRORS, a presigned S3 URL (valid for 10 minutes) is included in the response to download the error report CSV. The error report lists invalid rows and corresponding validation error messages for corrective re-import.
Poll this endpoint every 10-30 seconds after import submission until status is no longer IMPORTING.
## Scope
`wfm-public:read`
# OpenAPI definition
```json
{
"openapi": "3.0.2",
"info": {
"title": "Public API",
"version": "5.12.68",
"description": "Documents public API endpoints. Scopes are given to external software, that we don't control",
"contact": {
"name": "Talkdesk",
"url": "https://talkdesk.com"
}
},
"servers": [
{
"url": "https://api.talkdeskapp.com",
"description": "United States (td-us-1)"
},
{
"url": "https://api.talkdeskapp.eu",
"description": "Europe (td-eu-1)"
},
{
"url": "https://api.talkdeskappca.com",
"description": "Canada (td-ca-1)"
},
{
"url": "https://api.talkdeskapp.co.uk",
"description": "United Kingdom (td-uk-1)"
}
],
"tags": [
{
"name": "Schedule Event Import API",
"description": "Schedule Event Import API"
}
],
"paths": {
"/wfm/aion/v1/schedules/event-imports/{import_id}": {
"get": {
"x-namespace": "/wfm/aion",
"description": "Retrieves the current status of a schedule event import. Use this endpoint to poll for import completion after submitting a bulk import request.\n\nWhen status is IMPORTED_WITH_ERRORS, a presigned S3 URL (valid for 10 minutes) is included in the response to download the error report CSV. The error report lists invalid rows and corresponding validation error messages for corrective re-import.\n\nPoll this endpoint every 10-30 seconds after import submission until status is no longer IMPORTING.",
"operationId": "GetScheduleEventImport",
"parameters": [
{
"description": "The import UUID returned in the Location header from the POST endpoint",
"example": "92AF91D0759B11E989D9833F6973C849",
"in": "path",
"name": "import_id",
"required": true,
"schema": {
"description": "UUID of the import request (format: alphanumeric identifier)",
"maxLength": 255,
"minLength": 1,
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"description": "Status and errors for a schedule event import.",
"properties": {
"id": {
"description": "Unique identifier of the import.",
"example": "92AF91D0759B11E989D9833F6973C849",
"type": "string"
},
"status": {
"description": "Current status of the import.",
"enum": [
"PROCESSING",
"IMPORTED",
"IMPORTED_WITH_ERRORS",
"ERROR"
],
"type": "string"
},
"error_report_url": {
"description": "Presigned URL to download the error CSV report. Present only when status is IMPORTED_WITH_ERRORS.",
"example": "https://s3.amazonaws.com/bucket/errors.csv?X-Amz-Expires=600",
"type": "string"
},
"error_report_expires_at": {
"description": "Expiry timestamp of the presigned URL (ISO 8601). Present only when error_report_url is set.",
"example": "2024-01-01T12:10:00Z",
"type": "string",
"format": "date-time"
}
},
"required": [
"id",
"status"
],
"type": "object"
},
"example": {
"id": "92AF91D0759B11E989D9833F6973C849",
"status": "IMPORTED_WITH_ERRORS",
"total_events": 150,
"successful_events": 147,
"failed_events": 3,
"error_report_url": "https://s3.amazonaws.com/bucket/import-errors-abc123.csv?expires=1234567890"
}
}
},
"description": "Import status retrieved successfully"
},
"401": {
"content": {
"application/json": {
"example": {
"code": "1580005",
"message": "Invalid authentication. Token missing or expired."
},
"schema": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"description": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"description"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
}
}
}
}
},
"description": "Authentication token missing, expired, or invalid"
},
"403": {
"content": {
"application/json": {
"example": {
"code": "1580006",
"message": "Invalid permissions. You do not have access to this import."
},
"schema": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"description": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"description"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
}
}
}
}
},
"description": "Insufficient permissions or import belongs to a different account"
},
"404": {
"content": {
"application/json": {
"example": {
"code": "1580007",
"message": "Resource not found. Import ID 92AF91D0759B11E989D9833F6973C849 does not exist or has expired."
},
"schema": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"description": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"description"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
}
}
}
}
},
"description": "Import not found or has expired. Imports are retained for 30 days"
},
"500": {
"content": {
"application/json": {
"example": {
"code": "1230000",
"message": "An unknown error has occurred. Contact support with request ID."
},
"schema": {
"type": "object",
"required": [
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"message": {
"type": "string"
},
"description": {
"type": "string"
},
"fields": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"description"
],
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string"
}
}
}
}
}
}
}
},
"description": "Internal server error retrieving import status"
}
},
"security": [
{
"EarlyAccess": [
"wfm-public:read"
]
}
],
"summary": "Get schedule import status and error report URL",
"tags": [
"Schedule Event Import API"
]
}
}
},
"components": {
"securitySchemes": {
"EarlyAccess": {
"type": "oauth2",
"flows": {
"authorizationCode": {
"authorizationUrl": "https://{account_name}.talkdeskid.com/oauth/authorize",
"tokenUrl": "https://{account_name}.talkdeskid.com/oauth/token",
"scopes": {
"messages:read": "Ability to read messages from the API",
"presence-account:read": "Read Account presence",
"presence-user:read": "Read User presence",
"presence-occupancy:write": "Write User occupancy",
"presence-status:write": "Write User status",
"interactions-announcement:write": "Control the announcements in an interaction",
"contacts-custom-fields:read": "Search the custom fields for a given contact",
"contacts-activities:read": "List activities for a contact",
"wfm-public:read": "Get WFM related public data.",
"wfm-public:write": "Create, Update and Delete WFM related public data.",
"industries-activity:write": "Create and update industries activities and events",
"functions:execute": "Execute functions in external provider",
"phone-details:read": "Show phone details from a specific account",
"outbound-numbers:read": "List phone numbers that the agent can use for outbounds",
"numbers:read": "List numbers for an account",
"user-disposition-settings:write": "Update disposition settings for the user",
"attachments:download": "Generate a download link that gives temporary access to the attachment data",
"studio-callbacks:read": "List studio callbacks",
"attachments:read": "Get, and list attachments",
"attachments:request": "Get request ids and urls for uploading",
"attachments:write": "Create, and clone attachments",
"attachments:delete": "Delete an attachment permanently",
"simulated-emails:write": "Write to the eas send simulated email API",
"fsi-insurance-connections-contacts:read": "List and get insurance account holders",
"interactions-public:read": "Read interactions for an account",
"ccaas-user-status:write": "Update user status in ccaas",
"ccaas-user-status:read": "Read user status in ccaas",
"km-external-sources:read": "Read external sources in Talkdesk Knowledge Management",
"km-external-sources:write": "Manage external sources in Talkdesk Knowledge Management",
"omnichannel:interaction-elimination": "Eliminate an omnichannel interaction resource",
"industries-workato-hub": "Allow calling industries workato using a Talkdesk Id OAuth Client",
"secure-messaging:read": "Read secure messaging resources",
"secure-messaging:write": "Create, update secure messaging resources",
"digital-connection-execution:write": "Execute a digital connection action",
"digital-byob-webhook:write": "Reply, Escalate and Resolve Digital interactions via BYOB",
"customer-data-store:read": "Read the multi-channel message",
"email-connection-execution:write": "Execute email connection",
"outbound-notifications:write": "Send outbound notification messages",
"campaign-message:write": "Send campaign message",
"licenses:read": "Get the account licenses",
"seats:read": "Get seats information of a license",
"seats:write": "Add or remove seats from a license",
"recordings-consent:read": "Get consent recording links and metadata",
"voicemails:read": "List voicemails for an account",
"voicemails:write": "Change the voicemail status or assignment",
"ai-agent-conversations-export:read": "Export AI Agent conversations",
"data-datasets:read": "Lists, describes and queries reporting datasets through the dataset endpoints of Data Search API"
}
}
}
}
}
},
"externalDocs": {
"description": "External Documentation",
"url": "https://api-docs.talkdeskapp.com/external_docs"
}
}
```