Get Application Import¶

Endpoint: GET /api/application-imports/{id}

Description: Returns a single application import by its unique identifier, including build log, files, and metrics.

Path Parameters¶

Parameter	Type	Required	Description
`id`	string (GUID)	Yes	The unique identifier of the application import.

Response Attributes¶

Field	Type	Description
`id`	string (GUID)	Unique identifier of the import.
`kind`	string	Resource type. Always `Application Import`.
`number`	integer	Sequential import number.
`type`	string	Import type. Values: `Scheduled`, `Manual`, `API`.
`status`	string	Import status. Values: `Pending`, `Running`, `Finished`, `Failed`, `Canceled`, `Canceling`.
`createdBy`	string	Username that initiated the import.
`buildStart`	string (ISO 8601)	Date and time the import started.
`buildEnd`	string (ISO 8601)	Date and time the import completed. `null` if still running.
`log`	string	Import build log output.
`files`	array[object]	Files associated with this import.
`files[].id`	string (GUID)	Unique identifier of the import file.
`files[].fileGroupId`	string (GUID)	File group identifier from the connector definition.
`files[].fileGroup`	string	Display name of the file group.
`files[].name`	string	Original file name.
`metrics`	object	Import metrics. `null` unless the import status is `Finished`.
`metrics.users`	object	User account metrics.
`metrics.users.total`	integer	Total user accounts after import.
`metrics.users.new`	integer	New user accounts added.
`metrics.users.altered`	integer	Existing user accounts modified.
`metrics.users.removed`	integer	User accounts removed.
`metrics.groups`	object	Group metrics.
`metrics.groups.total`	integer	Total groups after import.
`metrics.groups.new`	integer	New groups added.
`metrics.groups.altered`	integer	Existing groups modified.
`metrics.groups.removed`	integer	Groups removed.
`metrics.permissions`	object	Permission metrics.
`metrics.permissions.total`	integer	Total permissions after import.
`metrics.permissions.new`	integer	New permissions added.
`application`	object	The application this import belongs to.
`application.id`	string (GUID)	Application ID.
`application.kind`	string	Always `Application`.
`application.name`	string	Application name.
`application.priority`	string	Priority rating. Values: `None`, `Low`, `Moderate`, `High`, `Critical`.
`application.isArchived`	boolean	Whether the application is archived.
`application.lastUpdated`	string (ISO 8601)	Application last updated date.

Sample Response¶

{
  "id": "f1e2d3c4-b5a6-9788-7654-321fedcba098",
  "kind": "Application Import",
  "number": 47,
  "type": "Scheduled",
  "status": "Finished",
  "createdBy": "Permission Assist",
  "buildStart": "2025-12-01T02:00:00Z",
  "buildEnd": "2025-12-01T02:14:32Z",
  "log": "Import started.\nReading files...\nProcessing users...\nProcessing groups...\nImport completed successfully.",
  "files": [
    {
      "id": "e1d2c3b4-a5f6-7890-1234-567890abcdef",
      "fileGroupId": "a1b2c3d4-0000-0000-0000-000000000001",
      "fileGroup": "Employee File",
      "name": "employees_20251201.csv"
    },
    {
      "id": "f2e3d4c5-b6a7-8901-2345-6789abcdef01",
      "fileGroupId": "a1b2c3d4-0000-0000-0000-000000000002",
      "fileGroup": "User Privileges File",
      "name": "privileges_20251201.csv"
    }
  ],
  "metrics": {
    "users": {
      "total": 1250,
      "new": 3,
      "altered": 12,
      "removed": 1
    },
    "groups": {
      "total": 87,
      "new": 0,
      "altered": 2,
      "removed": 0
    },
    "permissions": {
      "total": 342,
      "new": 5
    }
  },
  "application": {
    "id": "b8c1d2e3-4f5a-6b7c-8d9e-0f1a2b3c4d5e",
    "kind": "Application",
    "name": "Jack Henry Symitar",
    "priority": "Critical",
    "isArchived": false,
    "lastUpdated": "2025-12-01T08:45:00Z"
  }
}

Error Response (404)¶

{
  "error": "not_found",
  "message": "ApplicationImport with id f1e2d3c4-b5a6-9788-7654-321fedcba098 not found",
  "correlationId": "a1b2c3d4e5f6789012345678abcdef01"
}