Bulk Exports

For datasets larger than a single paginated response, use async export jobs. These run in the background and produce downloadable CSV files.

Creating an export

Submit an export job

curl -X POST https://nbaproplab.com/api/v1/data/exports \
  -H "X-API-Key: $NBAV3_DATA_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "picks",
    "format": "csv",
    "filters": {
      "from": "2026-01-01",
      "to": "2026-05-20",
      "rating": "Premium"
    }
  }'

Response:

{
  "id": 42,
  "status": "queued",
  "createdAt": "2026-05-20T15:00:00Z"
}

Poll for completion

curl -H "X-API-Key: $NBAV3_DATA_TOKEN" \
  https://nbaproplab.com/api/v1/data/exports/42

{
  "id": 42,
  "status": "completed",
  "rowCount": 1847,
  "artifactPath": "/api/v1/data/exports/42/download",
  "expiresAt": "2026-05-27T15:00:00Z"
}

Download the file

curl -H "X-API-Key: $NBAV3_DATA_TOKEN" \
  -o picks-export.csv \
  https://nbaproplab.com/api/v1/data/exports/42/download

Export types

Type	Description
`picks`	Scored picks with all fields, block scores, settlement
`settled_picks`	Settled picks only (hit/miss/push/void)
`line_movements`	Detected line changes (≥ 0.75pt delta)
`player_game_logs`	Per-game stat lines by player
`track_record`	Daily performance metrics
`backtest_daily`	Day-by-day backtest results
`market_capabilities`	Available markets and supported stat types

Job statuses

Status	Meaning
`queued`	Job is waiting to be processed
`running`	Export is in progress
`completed`	File is ready for download
`failed`	Export failed (check `errorMessage`)

Limits

Export files expire after 7 days
Maximum 10 concurrent export jobs per user
Maximum 100,000 rows per export

Managing exports

# List your export jobs
curl -H "X-API-Key: $NBAV3_DATA_TOKEN" \
  https://nbaproplab.com/api/v1/data/exports