Skip to main content
GET
/
api
/
v1
/
sync-status
Check Sync Status
curl --request GET \
  --url https://www.catchthegoodones.com/api/v1/sync-status
{
  "id": 42,
  "status": "completed",
  "progressLog": [
    "Fetching new followers...",
    "Found 150 new followers",
    "Classifying profiles...",
    "Classification complete"
  ],
  "completedAt": "2026-04-17T12:05:00.000Z",
  "newFollowersCount": 150,
  "deepCrawlCount": 45,
  "backfilledCount": 20,
  "likersCount": 30,
  "candidatesPassedCount": 12,
  "tierFilteredCount": 5,
  "genderFilteredCount": 3,
  "errorMessage": null
}
Returns the current status and result counts for a sync run. Use this to poll for completion after triggering a sync.

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer ctgo_your_api_key_here

​
Query parameters

ParameterRequiredDescription
syncRunIdYesThe sync run ID returned from the sync trigger endpoint

​
Example

curl "https://www.catchthegoodones.com/api/v1/sync-status?syncRunId=42" \
  -H "Authorization: Bearer ctgo_your_api_key_here"

​
Response

{
  "id": 42,
  "status": "completed",
  "progressLog": [
    "Fetching new followers...",
    "Found 150 new followers",
    "Classifying profiles...",
    "Classification complete"
  ],
  "completedAt": "2026-04-17T12:05:00.000Z",
  "newFollowersCount": 150,
  "deepCrawlCount": 45,
  "backfilledCount": 20,
  "likersCount": 30,
  "candidatesPassedCount": 12,
  "tierFilteredCount": 5,
  "genderFilteredCount": 3,
  "errorMessage": null
}

​
Response fields

FieldTypeDescription
idintegerSync run ID
statusstring"queued", "running", "completed", or "failed"
progressLogarrayOrdered list of progress messages
completedAtstring or nullISO 8601 completion timestamp
newFollowersCountintegerNew followers discovered
deepCrawlCountintegerExisting followers re-crawled
backfilledCountintegerProfiles backfilled with detailed data
likersCountintegerFast post likers discovered
candidatesPassedCountintegerCandidates that passed all filters
tierFilteredCountintegerCandidates filtered out by tier
genderFilteredCountintegerCandidates filtered out by gender
errorMessagestring or nullError message if status is "failed"