Data Migration - Get My Exports

Endpoint

/o/datamigration/getmyexports

Overview

Returns migration export records with derived file-availability flags.

Authentication

Pass api_key or auth_token as a query parameter, or send countly-token as a header. See Authentication.

Permissions

Requires data_migration Read permission.

Request Parameters

Parameter	Type	Required	Description
args	JSON String (Object)	No	Optional JSON-stringified helper args.
api_key	String	Conditional	Required if auth_token is not provided.
auth_token	String	Conditional	Required if api_key is not provided.

Examples

List exports

/o/datamigration/getmyexports

Response

Success Response

With exports:

{
  "result": [
    {
      "_id": "f9b35d90be5f2240eafced7c6bfdf130856cd0a7",
      "step": "exporting",
      "status": "progress",
      "progress": 35,
      "can_download": false,
      "have_folder": true,
      "log": "dm-export_f9b35d90be5f2240eafced7c6bfdf130856cd0a7.log"
    }
  ]
}

No exports:

{
  "result": "data-migration.no-exports"
}

Response Fields

Field	Type	Description
result	Array or String	Export list or no-exports key.
result[].can_download	Boolean	Whether final archive file exists.
result[].have_folder	Boolean	Whether unpacked export folder exists.
result[].log	String	Export log filename if available.

Error Responses

• 404

{
  "result": "Database error message"
}

Behavior

Behavior Modes

Mode	Trigger	Processing Path	Response Shape
Export list	Records found in migration collection	Returns sorted list and annotates each record with file/log availability flags.	Wrapped result array
No exports	No records found	Returns no-exports key.	Wrapped string

Impact on Other Data

• Read-only endpoint.

Related Endpoints

• Data Migration - Get Status
• Data Migration - Delete Export

Implementation details

Database Collections

Collection	Used for	Data touched by this endpoint
countly.data_migrations	Export status listing	Reads all migration records sorted by timestamp.