Skip to content
Pickleball API

Product overview

What is Pickleball API?

Pickleball API is a developer API for Major League Pickleball data: fixtures, live scores, matches, players, teams, rosters and standings over REST and WebSockets.

Pickleball API is for developers building scoreboards, league apps, bots, dashboards and research tools. Coverage today is Major League Pickleball. Authenticate with an API key, request JSON over REST, and optionally stream live updates over WebSockets.

Get an API keyRead the documentationCompare plans

Is there an API for pickleball data?

Yes. Pickleball API at pickleball-api.com exposes Major League Pickleball competitions, seasons, events, venues, teams, players, rosters, fixtures, matches, games, live score observations, standings and (on Pro) verified prediction-market data linked to fixtures.

Can I get pickleball scores via an API?

Yes. Poll GET /v1/fixtures/{id}/live for the latest observation on each match in a fixture, or read observation history with GET /v1/matches/{id}/observations. On the trial and Pro plans you can also subscribe to live match updates over wss://pickleball-api.com/v1/live.

cURL

curl -s "https://pickleball-api.com/v1/fixtures?status=in_progress" \
  -H "Authorization: Bearer pbl_live_YOUR_KEY"

JavaScript

const response = await fetch(
  'https://pickleball-api.com/v1/fixtures?status=in_progress',
  { headers: { Authorization: 'Bearer pbl_live_YOUR_KEY' } },
);
const body = await response.json();
console.log(body.data);

Python

import requests

response = requests.get(
    'https://pickleball-api.com/v1/fixtures',
    params={'status': 'in_progress'},
    headers={'Authorization': 'Bearer pbl_live_YOUR_KEY'},
)
response.raise_for_status()
print(response.json()['data'])

How do I get pickleball data in Python or JavaScript?

Pickleball API is a standard HTTPS JSON API. Use any HTTP client with an Authorization: Bearer pbl_live_… header. Call REST from your server, not from public browser code. For browser live updates, mint a short-lived ticket with POST /v1/realtime/tickets and connect the browser to the WebSocket with that ticket only.

Full authentication, envelope, error and streaming details are in the API documentation, including Python and JavaScript examples.

What data can developers access?

The REST surface is versioned under /v1. Successful responses use a { data, meta } envelope. Errors use RFC 9457 application/problem+json.

Catalogue

  • GET /v1/competitionsList competitions
  • GET /v1/seasonsList seasons
  • GET /v1/eventsList events
  • GET /v1/venues/{id}Venue detail

Teams & players

  • GET /v1/teamsList teams
  • GET /v1/teams/{id}/rosterEvent roster for a team
  • GET /v1/playersList players
  • GET /v1/players/{id}Player detail with DUPR ratings

Fixtures, matches & scores

  • GET /v1/fixturesList fixtures
  • GET /v1/fixtures/{id}/liveLatest observation per match
  • GET /v1/matches/{id}/gamesPer-game scores
  • GET /v1/matches/{id}/observationsObservation history

Standings & markets

  • GET /v1/events/{id}/standings/latestLatest event standings
  • GET /v1/seasons/{id}/standings/latestLatest season standings
  • GET /v1/fixtures/{id}/marketsVerified prediction markets (Pro)
  • GET /v1/liveWebSocket live stream (trial/Pro)

Machine-readable specs are published at OpenAPI and AsyncAPI.

Authentication and plans

Authenticate every REST request with Authorization: Bearer pbl_live_YOUR_KEY. Every verified account starts with a 14-day Pro trial (no card). After that:

  • Basic — $5/month, 25,000 REST calls/month, 90 days of history. No WebSockets or markets.
  • Pro — $10/month, 100,000 REST calls/month, 365 days of history, WebSockets (3 sockets, 100,000 outbound messages/month) and verified markets.

See pricing for annual options and full limits.

Common ways to use the API

  • Live scoreboards and second-screen apps with REST polling or WebSocket updates
  • League schedules, teams, rosters and standings in pickleball applications
  • Match and observation history for analysis and research
  • Verified prediction-market context for supported fixtures on Pro

Practical write-ups are on the developer blog, including getting started in five minutes and product ideas you can build.

Start building

Create an account, verify your email, copy your API key and make your first fixtures request. The trial includes Pro features for 14 days.

Get your API keyGetting started guide