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

# getTasks

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

## Request

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

List all tasks of a specified type: backup, restore, download (paginated).

## Path parameters

- `accountId` string, required

## Query parameters

- `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'
- `page` integer
- `pageSize` integer
- `type` 'BACKUP' | 'RESTORE' | 'EXPORT'

## Response `200`

Successful retrieval of the information.

- PageableResponseViewCollectionTaskView
  - `page` integer: Page number
  - `totalPages` integer: Total pages
  - `total` integer: Number of items per page
  - `nextPageToken` string: Next page token
  - `data` TaskView[]: Response items
    - `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
    - `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)