Skip to main content
GET
/
v1
/
synchronize
/
{sync_task_id}
Check Sync Status
curl --request GET \
  --url https://api.lobstr.io/v1/synchronize/{sync_task_id} \
  --header 'Authorization: <authorization>'
{
  "id": "<string>",
  "object": "<string>",
  "status_code": 123,
  "status_text": "<string>",
  "account_hash": "<string>"
}
This endpoint checks the synchronization status of a cookie update task using its hash ID. Use this to monitor whether your account cookies have been successfully synchronized.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY

​
Query Parameters

​
sync_task_id
string
required
The synchronization task ID returned from Sync Account or Refresh Cookies. Example: 75bed0d425c4bc1912a17fe9fc4dd2a1

​
Response Field Explanations

​
id
string
Synchronization task identifier. Example: "75bed0d425c4bc1912a17fe9fc4dd2a1"
​
object
string
Always “synchronize-cookies”. Example: "synchronize-cookies"
​
status_code
integer
Task status code (100=created, 120=synchronizing, 200=synchronized). Example: 200
​
status_text
string
Human-readable status. Example: "synchronized"
​
account_hash
string
Hash of the created/updated account. Example: "84efd37ebd21c0f232826b7763b403d3"
Poll this endpoint every few seconds after initiating a sync until status_code reaches 200 (synchronized) or an error state.
Once status_code is 200, use the returned account_hash to access the synchronized account with Get Account Details.
If synchronization remains at status_code 120 for more than 30 seconds, the cookies may be invalid. Try re-syncing with fresh cookies.

​
Code Examples

curl -X GET "https://api.lobstr.io/v1/synchronize/75bed0d425c4bc1912a17fe9fc4dd2a1" \
  -H "Authorization: Token YOUR_API_KEY"

​
Response

120
{
  "id": "75bed0d425c4bc1912a17fe9fc4dd2a1",
  "object": "synchronize-cookies",
  "status_code": 120,
  "status_text": "synchronizing",
  "account_hash": "84efd37ebd21c0f232826b7763b403d3"
}
200
{
  "id": "75bed0d425c4bc1912a17fe9fc4dd2a1",
  "object": "synchronize-cookies",
  "status_code": 200,
  "status_text": "synchronized",
  "account_hash": "84efd37ebd21c0f232826b7763b403d3"
}
404
{
  "detail": "Synchronization task not found."
}