BALLDONTLIE Lab API

v1.0.0

Build, backtest, and deploy betting models programmatically. The Lab API gives you access to pre-built analytical factors, model creation, historical backtesting, and prediction generation across multiple sports.

Quick Start

Create an account at lab-app.balldontlie.io
Upgrade to PRO or ALL-ACCESS (free tiers cannot access the API)
Grab your API key from your account settings

Authentication

All endpoints require authentication via API key in the Authorization header:

bash

curl "https://api.balldontlie.io/lab/v1/factors" \
  -H "Authorization: YOUR_API_KEY"

Rate Limits

Limit	Value
Requests per minute	100

Rate limit headers are included in every response:

Header	Description
`X-RateLimit-Limit`	Maximum requests per minute
`X-RateLimit-Remaining`	Requests remaining in current window
`X-RateLimit-Reset`	Unix timestamp when the limit resets

Supported Sports

Sport	Code	Status
NBA	`nba`	Available
NFL	`nfl`	Available
NHL	`nhl`	Available
MLB	`mlb`	Available

Subscription Tiers

Tier	Backtest History	Models	API Access
ALL-ACCESS	Full available history	Unlimited	Full
LAB PRO	Full available history	Unlimited	Full

Subscribe at lab-app.balldontlie.io to get started.

Base URL

https://api.balldontlie.io

OpenAPI Specification

Download or view the full OpenAPI specification for use with tools like Postman, Swagger UI, or code generators.

Download OpenAPI Spec (YAML)

GET/lab/v1/factors

List all factors

Returns all available factors for building prediction models.

Factors are pre-built analytical components that can be combined to create models.

Parameters

categorystringquery

Filter by factor category (team_performance, matchup, situational, player, market)

sportSportquery

Filter by sport (default nba)

Responses

200List of factors

dataFactor[]

Example Response

{
  "data": [
    {
      "id": 1,
      "slug": "team_last_n_pts_avg",
      "name": "Team Last N Games Scoring Average",
      "description": "Average points scored by team in their last N games.",
      "category": "team_performance",
      "sport": "nba",
      "output_type": "points",
      "raw_value_unit": "points per game",
      "configurable_params": {
        "n_games": {
          "type": "integer",
          "default": 10,
          "min": 3,
          "max": 30,
          "description": "Number of recent games to average"
        }
      }
    },
    {
      "id": 2,
      "slug": "team_last_n_pts_allowed_avg",
      "name": "Team Last N Games Points Allowed Average",
      "description": "Average points allowed by team in their last N games.",
      "category": "team_performance",
      "sport": "nba",
      "output_type": "points",
      "raw_value_unit": "points per game",
      "configurable_params": {
        "n_games": {
          "type": "integer",
          "default": 10,
          "min": 3,
          "max": 30,
          "description": "Number of recent games to average"
        }
      }
    }
  ]
}

Error Responses

400Invalid parameters

Example Request

cURL

curl -X GET "https://api.balldontlie.io/lab/v1/factors" \
  -H "Authorization: YOUR_API_KEY"

GET/lab/v1/factors/{id}

Get a factor

Returns details of a specific factor.

Parameters

idintegerpathrequired

Factor ID

Responses

200Factor details

dataFactor

Example Response

{
  "id": 1,
  "slug": "team_last_n_pts_avg",
  "name": "Team Last N Games Scoring Average",
  "description": "Average points scored by team in their last N games. Higher scoring indicates stronger offense.",
  "category": "team_performance",
  "sport": "nba",
  "output_type": "points",
  "raw_value_unit": "points per game",
  "configurable_params": {
    "n_games": {
      "type": "integer",
      "default": 10,
      "min": 3,
      "max": 30,
      "description": "Number of recent games to average"
    },
    "home_only": {
      "type": "boolean",
      "default": false,
      "description": "Only include home games"
    },
    "away_only": {
      "type": "boolean",
      "default": false,
      "description": "Only include away games"
    }
  }
}

Error Responses

400Invalid factor ID

404Factor not found

Example Request

cURL

curl -X GET "https://api.balldontlie.io/lab/v1/factors/{id}" \
  -H "Authorization: YOUR_API_KEY"

GET/lab/v1/models

List user's models

Returns all models owned by the authenticated user.

Parameters

sportstringquery

Filter by sport

bet_typestringquery

Filter by bet type

per_pageintegerquery

Number of results per page

cursorintegerquery

Cursor for pagination

Responses

200List of models

dataModel[]

metaCursorPagination

Example Response

{
  "data": [
    {
      "id": 1,
      "name": "Momentum Tracker",
      "description": "Tracks team momentum",
      "sport": "nba",
      "bet_type": "spread",
      "mode": "simple",
      "advanced_config": null,
      "created_at": "2026-01-31T22:08:30.516Z",
      "updated_at": "2026-01-31T22:08:30.516Z",
      "factors": [
        {
          "factor_id": 1,
          "factor_slug": "team_last_n_pts_avg",
          "factor_name": "Team Last N Games Scoring Average",
          "importance": "high",
          "weight": null,
          "parameters": null,
          "conditions": null
        }
      ]
    }
  ],
  "meta": {
    "per_page": 25
  }
}

Error Responses

400Invalid parameters

Example Request

cURL

curl -X GET "https://api.balldontlie.io/lab/v1/models" \
  -H "Authorization: YOUR_API_KEY"

POST/lab/v1/models

Create a model

Creates a new prediction model.

For weighted mode, factor weights must sum to 100.

Request Body

namestringrequired

Model name

descriptionstring

Model description

sportSport

Supported sports

nbanhlnflmlb

bet_typeBetTyperequired

Type of bet the model predicts

spreadmoneylineover_under

model_typeModelType

Type of model: - game: Predicts game-level outcomes (spread, moneyline, over/under) - player_prop: Predicts individual player stat lines (over/under the prop line)

gameplayer_prop

prop_typePropType

Stat type for player prop models (required when model_type is player_prop). NBA supports points, rebounds, assists, steals, blocks, and threes. NFL supports passing yards, passing touchdowns, passing attempts, passing completions, interceptions thrown, rushing yards, rushing attempts, receiving yards, receptions, and rushing plus receiving yards. MLB supports hits, total bases, home runs, RBIs, hits+runs+RBIs, runs, walks, stolen bases, singles, doubles, triples, pitcher strikeouts, pitcher outs, pitcher earned runs, pitcher hits allowed, and pitcher walks.

pointsreboundsassistsstealsblocksthreespassing_yardspassing_tdspassing_attemptspassing_completionsinterceptionsrushing_yardsrushing_attemptsreceiving_yardsreceptionsrushing_receiving_yardshitstotal_baseshome_runsrbishits_runs_rbisruns_scoredwalksstolen_basessinglesdoublestriplespitcher_strikeoutspitcher_outspitcher_earned_runspitcher_hits_allowedpitcher_walks

modeModelModerequired

Model calculation mode: - simple: Assign importance (Low/Medium/High) to each factor - weighted: Assign precise weights that must sum to 100%

simpleweighted

advanced_configAdvancedConfig

factorsModelFactorInput[]required

Factors to include in the model

Example Request

{
  "name": "Momentum Tracker",
  "description": "Tracks team momentum using recent scoring and ATS performance",
  "bet_type": "spread",
  "mode": "simple",
  "factors": [
    {
      "factor_id": 1,
      "importance": "high"
    },
    {
      "factor_id": 4,
      "importance": "high"
    },
    {
      "factor_id": 10,
      "importance": "medium"
    }
  ]
}

Responses

201Model created

dataModel

Example Response

{
  "id": 1,
  "name": "Momentum Tracker",
  "description": "Tracks team momentum using recent scoring and ATS performance",
  "sport": "nba",
  "bet_type": "spread",
  "mode": "simple",
  "advanced_config": null,
  "created_at": "2026-01-31T22:08:30.516Z",
  "updated_at": "2026-01-31T22:08:30.516Z",
  "factors": [
    {
      "factor_id": 1,
      "factor_slug": "team_last_n_pts_avg",
      "factor_name": "Team Last N Games Scoring Average",
      "importance": "high",
      "weight": null,
      "parameters": null,
      "conditions": null
    },
    {
      "factor_id": 4,
      "factor_slug": "team_ats_record",
      "factor_name": "Team Against The Spread Record",
      "importance": "high",
      "weight": null,
      "parameters": null,
      "conditions": null
    },
    {
      "factor_id": 10,
      "factor_slug": "rest_days",
      "factor_name": "Rest Days Advantage",
      "importance": "medium",
      "weight": null,
      "parameters": null,
      "conditions": null
    }
  ]
}

Error Responses

400Invalid request body or weights don't sum to 100

Example Request

cURL

curl -X POST "https://api.balldontlie.io/lab/v1/models" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Momentum Tracker",
  "description": "Tracks team momentum using recent scoring and ATS performance",
  "bet_type": "spread",
  "mode": "simple",
  "factors": [
    {
      "factor_id": 1,
      "importance": "high"
    },
    {
      "factor_id": 4,
      "importance": "high"
    },
    {
      "factor_id": 10,
      "importance": "medium"
    }
  ]
}'

GET/lab/v1/models/{id}

Get a model

Returns details of a specific model owned by the user.

Parameters

idintegerpathrequired

Model ID

Responses

200Model details

dataModel

Example Response

{
  "id": 1,
  "name": "Momentum Tracker",
  "description": "Tracks team momentum using recent scoring and ATS performance",
  "sport": "nba",
  "bet_type": "spread",
  "mode": "simple",
  "advanced_config": null,
  "created_at": "2026-01-31T22:08:30.516Z",
  "updated_at": "2026-01-31T22:08:30.516Z",
  "factors": [
    {
      "factor_id": 1,
      "factor_slug": "team_last_n_pts_avg",
      "factor_name": "Team Last N Games Scoring Average",
      "importance": "high",
      "weight": null,
      "parameters": null,
      "conditions": null
    },
    {
      "factor_id": 4,
      "factor_slug": "team_ats_record",
      "factor_name": "Team Against The Spread Record",
      "importance": "high",
      "weight": null,
      "parameters": null,
      "conditions": null
    },
    {
      "factor_id": 10,
      "factor_slug": "rest_days",
      "factor_name": "Rest Days Advantage",
      "importance": "medium",
      "weight": null,
      "parameters": null,
      "conditions": null
    }
  ]
}

Error Responses

400Invalid model ID

404Model not found

Example Request

cURL

curl -X GET "https://api.balldontlie.io/lab/v1/models/{id}" \
  -H "Authorization: YOUR_API_KEY"

PUT/lab/v1/models/{id}

Update a model

Updates an existing model.

For weighted mode, factor weights must sum to 100.

Note: Editing factors, mode, bet_type, prop_type, or advanced_config clears any existing performance and predictions data.

Parameters

idintegerpathrequired

Model ID

Request Body

namestring

Model name

descriptionstring

Model description

bet_typeBetType

Type of bet the model predicts

spreadmoneylineover_under

model_typeModelType

Type of model: - game: Predicts game-level outcomes (spread, moneyline, over/under) - player_prop: Predicts individual player stat lines (over/under the prop line)

gameplayer_prop

prop_typePropType

modeModelMode

Model calculation mode: - simple: Assign importance (Low/Medium/High) to each factor - weighted: Assign precise weights that must sum to 100%

simpleweighted

advanced_configAdvancedConfig

factorsModelFactorInput[]

Factors to include in the model

Example Request

{
  "name": "string",
  "description": "string",
  "bet_type": "spread",
  "model_type": "game",
  "prop_type": "points"
}

Responses

200Model updated

dataModel

Example Response

{
  "id": 1,
  "name": "Momentum Tracker",
  "description": "Tracks team momentum using recent scoring and ATS performance",
  "sport": "nba",
  "bet_type": "spread",
  "mode": "simple",
  "advanced_config": null,
  "created_at": "2026-01-31T22:08:30.516Z",
  "updated_at": "2026-01-31T22:08:30.516Z",
  "factors": [
    {
      "factor_id": 1,
      "factor_slug": "team_last_n_pts_avg",
      "factor_name": "Team Last N Games Scoring Average",
      "importance": "high",
      "weight": null,
      "parameters": null,
      "conditions": null
    },
    {
      "factor_id": 4,
      "factor_slug": "team_ats_record",
      "factor_name": "Team Against The Spread Record",
      "importance": "high",
      "weight": null,
      "parameters": null,
      "conditions": null
    },
    {
      "factor_id": 10,
      "factor_slug": "rest_days",
      "factor_name": "Rest Days Advantage",
      "importance": "medium",
      "weight": null,
      "parameters": null,
      "conditions": null
    }
  ]
}

Error Responses

400Invalid request body or weights don't sum to 100

404Model not found

409Model configuration cannot be changed while an evaluation or prediction job is active

Example Request

cURL

curl -X PUT "https://api.balldontlie.io/lab/v1/models/{id}" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string",
  "description": "string",
  "bet_type": "spread",
  "model_type": "game",
  "prop_type": "points"
}'

DELETE/lab/v1/models/{id}

Delete a model

Deletes a model and all associated data (predictions, performance, jobs).

Parameters

idintegerpathrequired

Model ID

Responses

204Model deleted

Error Responses

400Invalid model ID

404Model not found

Example Request

cURL

curl -X DELETE "https://api.balldontlie.io/lab/v1/models/{id}" \
  -H "Authorization: YOUR_API_KEY"

GET/lab/v1/predictions

List predictions for a model

Returns predictions for a specific model with game details.

Parameters

model_idintegerqueryrequired

Model ID (required)

resultstringquery

Filter by result (win, loss, push)

start_datestringquery

Filter by start date (ISO8601)

end_datestringquery

Filter by end date (ISO8601)

per_pageintegerquery

Number of results per page

cursorintegerquery

Cursor for pagination

Responses

200List of predictions with game details

dataPredictionWithGame[]

metaCursorPagination

Example Response

{
  "data": [],
  "meta": {
    "per_page": 25
  }
}

Error Responses

400Invalid parameters

404Model not found

Example Request

cURL

curl -X GET "https://api.balldontlie.io/lab/v1/predictions" \
  -H "Authorization: YOUR_API_KEY"

GET/lab/v1/predictions/stats

Get prediction statistics

Returns aggregate statistics for a model's predictions.

Parameters

model_idintegerqueryrequired

Model ID (required)

Responses

200Prediction statistics

dataPredictionStats

Example Response

{
  "data": {
    "total": 0,
    "wins": 0,
    "losses": 0,
    "pushes": 0,
    "win_rate": 0
  }
}

Error Responses

400Invalid parameters

404Model not found

Example Request

cURL

curl -X GET "https://api.balldontlie.io/lab/v1/predictions/stats" \
  -H "Authorization: YOUR_API_KEY"

GET/lab/v1/predictions/{id}

Get a prediction

Returns details of a specific prediction.

Parameters

idintegerpathrequired

Prediction ID

Responses

200Prediction details

dataPrediction

Example Response

{
  "data": {
    "id": 48,
    "model_id": 175,
    "game_id": 18447533,
    "predicted_value": 5,
    "confidence": 0.05,
    "market_value": 0,
    "edge": null,
    "actual_value": null,
    "result": null,
    "home_ml": -110,
    "away_ml": -110,
    "created_at": "2026-02-01T20:37:06.510Z",
    "resolved_at": null
  }
}

Error Responses

400Invalid prediction ID

404Prediction not found

Example Request

cURL

curl -X GET "https://api.balldontlie.io/lab/v1/predictions/{id}" \
  -H "Authorization: YOUR_API_KEY"

POST/lab/v1/models/{id}/predictions/generate

Generate predictions

Creates a background job to generate predictions for upcoming games.

Poll the job endpoint to get results.

Note: Only one prediction generation job can run per model at a time. If a pending

or running job already exists, a 409 Conflict is returned.

Parameters

idintegerpathrequired

Model ID

Responses

201Job created

dataJob

Example Response

{
  "data": {
    "id": "6e931b7f-736f-4386-b8a2-1cfa8565e8a8",
    "model_id": 175,
    "job_type": "generate_predictions",
    "status": "pending",
    "output": null,
    "error_message": null,
    "created_at": "2026-02-01T20:36:55.874Z",
    "started_at": null,
    "completed_at": null
  }
}

Error Responses

400Invalid model ID

404Model not found

409Prediction generation already running

Example Request

cURL

curl -X POST "https://api.balldontlie.io/lab/v1/models/{id}/predictions/generate" \
  -H "Authorization: YOUR_API_KEY"

POST/lab/v1/performance/preview

Create preview job

Creates a background job to preview model performance without saving.

Returns historical performance. The response retains an empty predictions array for compatibility;

use a saved model's prediction-generation endpoint for upcoming games.

Poll the job endpoint to get results.

Request Body

bet_typeBetTyperequired

Type of bet the model predicts

spreadmoneylineover_under

modeModelModerequired

Model calculation mode: - simple: Assign importance (Low/Medium/High) to each factor - weighted: Assign precise weights that must sum to 100%

simpleweighted

sportSport

Supported sports

nbanhlnflmlb

model_typeModelType

Type of model: - game: Predicts game-level outcomes (spread, moneyline, over/under) - player_prop: Predicts individual player stat lines (over/under the prop line)

gameplayer_prop

prop_typePropType

advanced_configAdvancedConfig

factorsPreviewFactorInput[]required

Factors for the preview

seasononeOf

NBA/NHL use YYYY-YY; NFL/MLB use YYYY. Game-model history starts in 2020, while NFL and MLB player-prop history starts in 2025. Omit for the account's default access window.

Example Request

{
  "bet_type": "spread",
  "mode": "simple",
  "factors": [
    {
      "factor_id": 1,
      "importance": "high"
    },
    {
      "factor_id": 2,
      "importance": "medium"
    }
  ]
}

Responses

201Preview job created

dataJob

Example Response

{
  "id": "616aacdb-1501-47d9-b09c-ac3164f6885b",
  "model_id": null,
  "job_type": "preview",
  "status": "pending",
  "output": null,
  "error_message": null,
  "created_at": "2026-01-31T22:15:59.724Z",
  "started_at": null,
  "completed_at": null
}

Error Responses

400Invalid request body

Example Request

cURL

curl -X POST "https://api.balldontlie.io/lab/v1/performance/preview" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "bet_type": "spread",
  "mode": "simple",
  "factors": [
    {
      "factor_id": 1,
      "importance": "high"
    },
    {
      "factor_id": 2,
      "importance": "medium"
    }
  ]
}'

GET/lab/v1/models/{id}/performance

Get model performance

Returns performance evaluation results for a model.

Returns null if evaluation has not been run yet.

Parameters

idintegerpathrequired

Model ID

Responses

200Performance results (null if not evaluated)

dataoneOf

Example Response

{
  "data": null
}

Error Responses

400Invalid model ID

404Model not found

Example Request

cURL

curl -X GET "https://api.balldontlie.io/lab/v1/models/{id}/performance" \
  -H "Authorization: YOUR_API_KEY"

POST/lab/v1/models/{id}/performance

Trigger performance evaluation

Creates a background job to run performance evaluation for a model against historical data.

Returns immediately with a job object - poll the job endpoint to get results.

Keeps the last completed performance visible while the new evaluation runs and replaces it only after success.

Season Format: NBA/NHL use "YYYY-YY" (for example "2025-26"); NFL/MLB use "YYYY".

Game-model seasons are supported from 2020 through the current sport season. NFL and MLB player-prop seasons are supported from 2025 onward. The current season rolls over automatically.

Note: Only one evaluation job can run per model at a time. If a pending or running

evaluation job already exists, a 409 Conflict is returned.

Parameters

idintegerpathrequired

Model ID

Request Body

seasononeOf

NBA/NHL use YYYY-YY (for example 2025-26); NFL/MLB use YYYY. Game-model history starts in 2020, while NFL and MLB player-prop history starts in 2025. The latest season rolls over automatically at that sport's configured start month.

Example Request

{
  "season": "string"
}

Responses

201Evaluation job created

dataJob

Example Response

{
  "data": {
    "id": "81cea460-5e30-4f15-9e0d-9493541a3c7d",
    "model_id": 1,
    "job_type": "evaluate",
    "status": "pending",
    "output": null,
    "error_message": null,
    "created_at": "2026-01-31T22:14:50.285Z",
    "started_at": null,
    "completed_at": null
  }
}

Error Responses

400Invalid request (season format, etc.)

404Model not found

409Evaluation already running

Example Request

cURL

curl -X POST "https://api.balldontlie.io/lab/v1/models/{id}/performance" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "season": "string"
}'

DELETE/lab/v1/models/{id}/performance

Clear performance data

Clears all performance evaluation data for a model.

Parameters

idintegerpathrequired

Model ID

Responses

204Performance data cleared

Error Responses

400Invalid model ID

404Model not found

Example Request

cURL

curl -X DELETE "https://api.balldontlie.io/lab/v1/models/{id}/performance" \
  -H "Authorization: YOUR_API_KEY"

GET/lab/v1/models/{id}/performance/games

Get per-game performance details

Returns paginated per-game breakdown of performance evaluation.

Parameters

idintegerpathrequired

Model ID

limitintegerquery

Number of results per page

offsetintegerquery

Number of results to skip

resultstringquery

Filter by result

winlosspushpending

Responses

200Per-game performance details

dataPerformanceGameResult[]

metaOffsetPagination

Example Response

{
  "data": [
    {
      "date": "2024-10-22",
      "result": "loss",
      "game_id": 15907439,
      "away_team": {
        "id": 18,
        "name": "Timberwolves",
        "abbreviation": "MIN"
      },
      "home_team": {
        "id": 14,
        "name": "Lakers",
        "abbreviation": "LAL"
      },
      "is_future": false,
      "away_score": 103,
      "confidence": 0,
      "home_score": 110,
      "market_value": 1.5,
      "factor_details": {
        "away": [
          {
            "score": 80,
            "raw_value": 7,
            "parameters": {},
            "factor_slug": "rest_days"
          },
          {
            "score": 50,
            "raw_value": 50,
            "parameters": {
              "n_games": 20
            },
            "factor_slug": "team_ats_record"
          }
        ],
        "home": [
          {
            "score": 80,
            "raw_value": 7,
            "parameters": {},
            "factor_slug": "rest_days"
          },
          {
            "score": 50,
            "raw_value": 50,
            "parameters": {
              "n_games": 20
            },
            "factor_slug": "team_ats_record"
          }
        ]
      },
      "predicted_side": "away",
      "away_model_score": 53,
      "home_model_score": 53
    }
  ],
  "meta": {
    "total": 1321,
    "limit": 25,
    "offset": 0
  }
}

Error Responses

400Invalid parameters

404Model not found

Example Request

cURL

curl -X GET "https://api.balldontlie.io/lab/v1/models/{id}/performance/games" \
  -H "Authorization: YOUR_API_KEY"

GET/lab/v1/jobs/{id}

Get job status

Returns the status and output of a background job.

Poll this endpoint until status is "completed" or "failed".

Parameters

idstringpathrequired

Job ID (UUID)

Responses

200Job status and output

dataJob

Example Response

{
  "id": "81cea460-5e30-4f15-9e0d-9493541a3c7d",
  "model_id": 1,
  "job_type": "generate_predictions",
  "status": "pending",
  "output": null,
  "error_message": null,
  "created_at": "2026-01-31T22:14:50.285Z",
  "started_at": null,
  "completed_at": null
}

Error Responses

400Invalid job ID (must be valid UUID)

404Job not found

Example Request

cURL

curl -X GET "https://api.balldontlie.io/lab/v1/jobs/{id}" \
  -H "Authorization: YOUR_API_KEY"

DELETE/lab/v1/jobs/{id}

Cancel a job

Cancels a pending or running job. Only jobs with status "pending" or "running" can be cancelled.

Cancelled jobs have their status set to "cancelled" with error message "Cancelled by user".

Parameters

idstringpathrequired

Job ID (UUID)

Responses

200Job cancelled successfully

dataJob

Example Response

{
  "id": "81cea460-5e30-4f15-9e0d-9493541a3c7d",
  "model_id": 1,
  "job_type": "evaluate",
  "status": "cancelled",
  "output": null,
  "error_message": "Cancelled by user",
  "created_at": "2026-01-31T22:14:50.285Z",
  "started_at": null,
  "completed_at": "2026-01-31T22:15:02.123Z"
}

Error Responses

400Job cannot be cancelled (already completed, failed, or cancelled)

404Job not found

Example Request

cURL

curl -X DELETE "https://api.balldontlie.io/lab/v1/jobs/{id}" \
  -H "Authorization: YOUR_API_KEY"

GET/lab/v1/models/{id}/jobs/active

Get active jobs for a model

Returns all pending and running jobs for a specific model.

Used to determine if a model has jobs in progress that would prevent new jobs from being created.

Parameters

idintegerpathrequired

Model ID

Responses

200List of active jobs

dataJob[]

Example Response

{
  "data": [
    {
      "id": "81cea460-5e30-4f15-9e0d-9493541a3c7d",
      "model_id": 1,
      "job_type": "evaluate",
      "status": "running",
      "output": null,
      "error_message": null,
      "created_at": "2026-01-31T22:14:50.285Z",
      "started_at": "2026-01-31T22:14:51.212Z",
      "completed_at": null
    }
  ]
}

Error Responses

400Invalid model ID

404Model not found

Example Request

cURL

curl -X GET "https://api.balldontlie.io/lab/v1/models/{id}/jobs/active" \
  -H "Authorization: YOUR_API_KEY"