Getting job status

Endpoint

GET https://api.socialdata.tools/jobs/[job_id]

Endpoint parameters

Name	Description	Example
job_id (Required)	A numeric ID of a job you created earlier using one of the async endpoints	42

Response codes

• HTTP 200 OK - succeeded

• HTTP 403 Forbidden - requested job belongs to another user

• HTTP 404 Not Found - requested job does not exist

• HTTP 500 Internal Server Error - other error (highly unlikely)

Example request

curl "https://api.socialdata.tools/jobs/42
-H 'Authorization: Bearer API_KEY'
-H 'Accept: application/json'

Example response

// Job pending, processing not started yet: 
{
    "job_id": 42,
    "status": "pending"
}

// Job still being processed: 
{
    "job_id": 42,
    "status": "processing"
}


// Job finished successfully: 
{
    "job_id": 42,
    "status": "success",
    "result": {
        "datafile_url": "https://s3.amazonaws.com/..."    
    }
}

// Job failed: 
{
    "job_id": 42,
    "status": "error"
    "message": "Insufficient balance"
}