Backups

Get Backups

Todoist creates a backup archive of users' data on a daily basis. Backup archives can also be accessed from the web app (Todoist Settings -> Backups).

This endpoint accepts the backups:read scope, the data:read_write scope, or a personal API token. The backups:read scope bypasses MFA and only grants access to GET /api/v1/backups. When using data:read_write or a personal API token for an account with MFA enabled, the MFA token is required.

get/api/v1/backups

Query parameters

mfa_tokenstring nullable

MFA token required when using a data:read_write token for an account with MFA enabled.

Example:123456

Response

Successful Response

versionstring required

Date and time of the backup version

urlstring required

Backup URL

Example response

[
  {
    "version": "2025-02-13 02:03",
    "url": "https://api.todoist.com/api/v1/backups/download?file=12345678901234567890123456789012.zip"
  }
]

Changes

No recorded changes to this endpoint across all 10 revisions of this API.