Skip to main content
Every agent run creates a job. Jobs track the execution lifecycle from queued to completed. Use these endpoints to manage your jobs.

​
Job Statuses

StatusDescription
queuedJob is waiting to be processed
runningAgent is actively collecting data
completedFinished successfully — results are available
failedEncountered an error — check the error message
cancelledCancelled by the user — no credits charged

​
List All Jobs

Returns all jobs for your account, newest first. 
curl https://api.mindcase.co/api/v1/jobs \
  -H "Authorization: Bearer mk_live_abc123def456"
Response
{
  "jobs": [
    {
      "id": "job_7f3a2b1c",
      "status": "completed",
      "agent": "instagram/profile-scraper",
      "row_count": 3,
      "credits_used": 3,
      "created_at": "2026-03-30T10:15:00Z",
      "completed_at": "2026-03-30T10:15:32Z"
    },
    {
      "id": "job_9e2d4a5b",
      "status": "running",
      "agent": "linkedin/company-employees",
      "row_count": 0,
      "credits_used": 0,
      "created_at": "2026-03-30T10:12:00Z",
      "completed_at": null
    }
  ]
}

​
Get Job Status

curl https://api.mindcase.co/api/v1/jobs/job_7f3a2b1c \
  -H "Authorization: Bearer mk_live_abc123def456"
Response
{
  "id": "job_7f3a2b1c",
  "status": "completed",
  "agent": "instagram/profile-scraper",
  "row_count": 3,
  "credits_used": 3,
  "created_at": "2026-03-30T10:15:00Z",
  "completed_at": "2026-03-30T10:15:32Z",
  "expires_at": "2026-04-06T10:15:00Z"
}
Job results expire after 7 days. Download your data before the expires_at timestamp.

​
Get Job Results

Returns the collected data for a completed job. Returns 404 if the job is still running. 
curl https://api.mindcase.co/api/v1/jobs/job_7f3a2b1c/results \
  -H "Authorization: Bearer mk_live_abc123def456"
Response
{
  "status": "completed",
  "row_count": 3,
  "data": [
    {
      "username": "nike",
      "fullName": "Nike",
      "followersCount": 306000000,
      "verified": true,
      "biography": "Just Do It."
    }
  ]
}

​
Cancel a Job

Cancel a queued or running job. Credits are not charged for cancelled jobs. 
curl -X DELETE https://api.mindcase.co/api/v1/jobs/job_9e2d4a5b \
  -H "Authorization: Bearer mk_live_abc123def456"
Response
{
  "job_id": "job_9e2d4a5b",
  "status": "cancelled",
  "message": "Job has been cancelled."
}