Skip to main content
GET
Get all data snapshot statuses

Authorizations

Authorization
string
header
required

Use your Bright Data API Key as a Bearer token in the Authorization header.

How to authenticate:

  1. Obtain your API Key from the Bright Data account settings at https://brightdata.com/cp/setting/users
  2. Include the API Key in the Authorization header of your requests
  3. Format: Authorization: Bearer YOUR_API_KEY

Example:

Learn how to get your Bright Data API key: https://docs.brightdata.com/api-reference/authentication

Response

List of data snapshot statuses

dump_id
string
required

Unique identifier for the dump

id
string
required

Same as dump_id (included for compatibility)

status
enum<string>
required

Current status of the dump

Available options:
in_progress
created
string<date-time>
required

Timestamp when the dump was created

search_id
string
required

ID of the search this dump is based on

readiness
string
required

Percentage of completion (e.g., "22.31%")

batches_total
integer
required

Total number of batches to process

batches_uploaded
integer
required

Number of batches uploaded so far

files_total
integer
required

Total number of files in the dump

files_uploaded
integer
required

Number of files uploaded so far

filters
object

Filters used to create the dump (present in list endpoint)