---
title: "getTask"
method: GET
path: "/v2/resellers/accounts/{accountId}/backup-tasks/{id}"
tags: ["Reseller Backup management"]
---

# getTask

`GET /v2/resellers/accounts/{accountId}/backup-tasks/{id}`

## Request

- Base URL: `https://api.cloudally.com`
- URL: `https://api.cloudally.com/v2/resellers/accounts/{accountId}/backup-tasks/{id}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/cloudally/apis/cloudally-rest-api/docs/v2/resellers/accounts/:accountId/backup-tasks/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Get information for the specified task

## Path parameters

- `id` string, required
- `accountId` string, required

## Response `200`

Successful retrieval of the information.

- TaskViewWithEntities
  - `id` string: Task ID
  - `account` string: Account name
  - `type` 'BACKUP' | 'RESTORE' | 'DEACTIVATEUSER' | 'DELETEACCOUNTDATA' | 'FINISHEDACK' | 'TERMINATE_MACHINE' | 'EXPORT' | 'MIGRATE' | 'DELETEINDEXDATA' | 'INDEX' | 'DELETEITEMS' | 'COMPARISON' | 'EXPORTACTIVITY' | 'PP_EXPORTACTIVITY': Task type
  - `source` 'GMAIL' | 'GDOC' | 'GDRIVETEAM' | 'SFC' | 'GOOGLEAPPS' | 'GCALENDAR' | 'GTASK' | 'GCONTACTS' | 'YMAIL' | 'GACCOUNTS' | 'GSITES' | 'SDB' | 'O365MAIL' | 'O365CONTACTS' | 'DDB' | 'MS365' | 'O365CALENDAR' | 'O365TASKS' | 'SHAREPOINT' | 'SHAREPOINT_MULTI' | 'ONEDRIVE' | 'IMAP' | 'BOX' | 'PUBLICWORDPRESS' | 'DROPBOX' | 'MS365GROUPS' | 'MS365GROUP_CONVERSATIONS' | 'MS365GROUP_CALENDAR' | 'MS365GROUP_SITE' | 'MS365GROUP_META' | 'O365NOTES' | 'MS365TEAM_CHANNELS' | 'MS365TEAM_APPS' | 'MSTEAMS' | 'MSGROUPS' | 'INTERNAL' | 'DYNAMICS365' | 'ENTRAID': Service name
  - `userId` string: User ID
  - `domain` string: Domain name (SimpleDB, DynamoDB)
  - `status` 'ACTIVE' | 'NOTACTIVE' | 'IN_ANOTHER' | 'PENDING' | 'PAUSED' | 'ON_PREMISE' | 'SKIPPED' | 'DISPATCHED' | 'QUEUED' | 'INPROCESS' | 'ARCHIVED': Task status
  - `region` 'US_EST' | 'US_EST_OHIO' | 'US_WEST_OREGON' | 'US_WEST_CAL' | 'EU' | 'EU_FRANKFURT' | 'ASIA_HONG_KONG' | 'ASIA_MUMBAI' | 'ASIA_SEOUL' | 'ASIA_SINGAPORE' | 'ASIA_SIDNEY' | 'ASIA_TOKYO' | 'SOUTH_AMERICA' | 'AFRICA_CAPE_TOWN' | 'ASIA_CHINA' | 'CANADA' | 'LONDON' | 'EU_PARIS' | 'EU_STOCKHOLM' | 'EU_ZURICH': Data center (SimpleDB, DynamoDB)
  - `alias` string: Friendly name
  - `backupTaskId` string: Backup task ID
  - `index` boolean: Index flag
  - `snapshotDate` integer: Snapshot date (yyyyMMddHHmmss)
  - `lastBackupDates` object: Last successful backup dates table per each sub-sourse (mail, calendar, tasks, etc.) (yyyyMMddHHmmss)
  - `nextBackup` string: Schedule for the next backup
  - `progress` TaskProgressView
    - `current` integer: The number of processed items at the moment
    - `state` 'PREPARE' | 'BACKUP' | 'FINALIZE': State of the backup process
    - `service` string: Service name
    - `cancelled` boolean
  - `size` integer: Backup size (bytes)
  - `createDate` string, date-time: Date and time when this task was created.
  - `numOfBilledEntities` integer: Number of billed entities
  - `numOfEntities` integer: Total number of entities
  - `entities` EntityView[]: A list of accounts or sites for the task
    - `id` string: Site or account ID
    - `userId` string: User ID
    - `taskId` string: Task ID
    - `entity` string: Site or account name
    - `status` 'ACTIVE' | 'NOTACTIVE' | 'IN_ANOTHER' | 'PENDING' | 'PAUSED' | 'ON_PREMISE' | 'SKIPPED' | 'DISPATCHED' | 'QUEUED' | 'INPROCESS' | 'ARCHIVED': Task status
    - `lastBackupDates` object: Last backup dates per each sub-source (Mail, Calendar, Tasks, etc.)
    - `fullName` string: Name
    - `progress` TaskProgressView
      - `current` integer: The number of processed items at the moment
      - `state` 'PREPARE' | 'BACKUP' | 'FINALIZE': State of the backup process
      - `service` string: Service name
      - `cancelled` boolean
    - `extId` string: Site or account ID in the external system
  - `multiEntitiesTask` boolean

## Other responses

- `401`: The user is not logged in.
- `403`: The user does not have an access to view the account activity.

---

[API](https://skmtc.dev/cloudally/apis/cloudally-rest-api.md) - [All operations](https://skmtc.dev/cloudally/apis/cloudally-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudally/apis/cloudally-rest-api/revisions/97e3a3740b5b?raw)