Get Job Status

Retrieve Job Information

curl --request GET \
  --url https://api.uplift.ai/v1/data/export/job/{jobId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.uplift.ai/v1/data/export/job/{jobId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.uplift.ai/v1/data/export/job/{jobId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.uplift.ai/v1/data/export/job/{jobId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.uplift.ai/v1/data/export/job/{jobId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "jobId": "<string>",
  "status": "RUNNING",
  "errorMessage": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z"
}

{
  "error": "BadRequest",
  "message": "The request parameters are invalid. Please review the request and try again."
}

{
  "error": "Unauthorized",
  "message": "Bearer token is missing or invalid."
}

{
  "error": "Forbidden",
  "message": "You do not have permission to access this resource."
}

{
  "error": "NotFound",
  "message": "The specified job ID was not found."
}

{
  "error": "TooManyRequests",
  "message": "The rate limit has been exceeded. Please wait and try again later."
}

{
  "error": "InternalServerError",
  "message": "An unexpected error occurred on the server. Please try again later."
}

GET

data

export

job

{jobId}

Retrieve Job Information

curl --request GET \
  --url https://api.uplift.ai/v1/data/export/job/{jobId} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.uplift.ai/v1/data/export/job/{jobId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.uplift.ai/v1/data/export/job/{jobId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.uplift.ai/v1/data/export/job/{jobId}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.uplift.ai/v1/data/export/job/{jobId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "jobId": "<string>",
  "status": "RUNNING",
  "errorMessage": "<string>",
  "createdAt": "2023-11-07T05:31:56Z",
  "completedAt": "2023-11-07T05:31:56Z"
}

{
  "error": "BadRequest",
  "message": "The request parameters are invalid. Please review the request and try again."
}

{
  "error": "Unauthorized",
  "message": "Bearer token is missing or invalid."
}

{
  "error": "Forbidden",
  "message": "You do not have permission to access this resource."
}

{
  "error": "NotFound",
  "message": "The specified job ID was not found."
}

{
  "error": "TooManyRequests",
  "message": "The rate limit has been exceeded. Please wait and try again later."
}

{
  "error": "InternalServerError",
  "message": "An unexpected error occurred on the server. Please try again later."
}

Polling

The job status is RUNNING until the export finishes. Poll this endpoint until it returns COMPLETED, then request the results. Until this endpoint has reported COMPLETED, the results endpoint returns no rows.

Export too large

When an export runs out of memory while it is being built, the job ends FAILED and errorMessage explains that the export is too large:

{
  "jobId": "17eafc5c-2e4d-44e9-bdfe-7617591a5f00",
  "status": "FAILED",
  "errorMessage": "Export too large: the cluster ran out of memory while building this export. Narrow the date range or request fewer athletes.",
  "createdAt": "2026-09-30T17:40:51.000Z",
  "completedAt": "2026-09-30T17:41:43.000Z"
}

Submit a new export with a shorter date range or fewer athletes.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

jobId

string

required

The unique identifier for the job to be retrieved.

Response

Successful retrieval of job details.

jobId

string

The unique identifier for the job.

status

enum<string>

The current status of the job.

Available options:

RUNNING,

COMPLETED,

FAILED,

CANCELED

errorMessage

string

Detailed error message if the job failed.

createdAt

string<date-time>

The time at which the job was created.

completedAt

string<date-time>

The time at which the job was completed, if applicable.

API Documentation

Data Export

Captures

Athletes

Get Job Status

Polling

Export too large

Authorizations

Path Parameters

Response

​Polling

​Export too large

Authorizations

Path Parameters

Response

Polling

Export too large