Skip to main content
The NBA tier on your BALLDONTLIE account decides which endpoints your API key can reach. On the FREE tier the key only reaches Basic endpoints — requests to endpoints above your tier return 401 until you upgrade to ALL-STAR or GOAT.

​
Create your BALLDONTLIE account

BALLDONTLIE issues an API key automatically as soon as you create an account — there is no app to register and nothing to generate. If you already have an account, skip straight to signing in.

1

Create a BALLDONTLIE account

Open the BALLDONTLIE account sign-up page, or click Sign Up in the top-right corner. On the CREATE AN ACCOUNT screen, fill in email, password and confirm password, then click Submit.

  • A free account requires no payment details.
The BALLDONTLIE CREATE AN ACCOUNT screen with the email, password and confirm password fields and the Submit button highlighted.
2

Sign in to your account

Go to the BALLDONTLIE account portal and sign in. On the WELCOME BACK screen, enter your email and password, then click Submit.

The BALLDONTLIE WELCOME BACK sign-in screen with the email and password fields and the Submit button highlighted.

​
Copy your API key

Your key lives on the Account page of the portal and is the only value StackOne needs.

1

Open the Account page

In the left sidebar, click Account. The Account page opens with an API Key card at the top, above the Account and Billing History cards.

The BALLDONTLIE Account page with the Account item highlighted in the left sidebar and the API Key card shown at the top.
2

Copy the API key

In the API Key card, your key is shown in the YOUR API KEY box. Click Copy at the right-hand end of the box to copy it to your clipboard.

  • API Key — the value in the YOUR API KEY box. Paste it into the API Key field in StackOne Hub.
  • Format: 12345678-abcd-1234-abcd-1234567890ab (a UUID)
  • The key is not displayed once — it stays visible on the Account page, so you can come back and copy it again at any time.
  • Rotate key issues a replacement key and invalidates the current one. Only use it if the key has leaked, and update the value in StackOne Hub afterwards.
The API Key card on the BALLDONTLIE Account page with the YOUR API KEY box and the Copy button highlighted, the key value masked.

​
Choose the NBA tier you need

Tiers are bought per sport, so an NBA subscription does not carry over to the other BALLDONTLIE APIs. The same key keeps working after an upgrade — no change is needed in StackOne Hub.

1

Open the Subscriptions page

In the left sidebar, click Subscriptions. On the Subscriptions page, the Available Sports table lists every sport with its current tier. Find NBA under BASKETBALL and click Upgrade on that row.

  • Upgrade to ALL-ACCESS at the top of the page covers every sport and endpoint at $299.99 per month, and includes BDL Lab, Webhooks, and StoryStats.
The BALLDONTLIE Subscriptions page showing the Available Sports table, with Subscriptions highlighted in the sidebar and the NBA row and its Upgrade button highlighted.
2

Review the NBA tiers

The NBA dialog shows your Current: tier and the three plans you can move to. Pick the tier that covers the endpoints you need, then click SUBSCRIBE on that card.

  • FREE — 0</strong>,<strong>Basicendpoints</strong>.</li><li><strong>ALL−STAR</strong>—<strong>0</strong>, <strong>Basic endpoints</strong>.</li> <li><strong>ALL-STAR</strong> — <strong>9.99/mo, Extended access.
  • GOAT — $39.99/mo, Full access.
  • Try GOAT free for 48 hours — click Start trial for full endpoint access. Card required. No charge until the trial ends — cancel anytime.
  • View available endpoints by tier opens the NBA API account tiers reference — the full list of endpoints included in each plan.
The NBA upgrade dialog showing the FREE, ALL-STAR and GOAT tier cards and the Try GOAT free for 48 hours banner with the Start trial button.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • API Key
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.