Title: Sport Schedule

URL Source: https://docs.shipp.ai/api-reference/sport-schedule/

Markdown Content:
---
description: API Reference to Sport Schedules
---

[ Skip to content](#get-apiv1sportssportschedule) 

* [  How to Shipp ](../../how-to/)
* [  API Reference ](../)
* [  Run Connection Output ](../connections-run-data-shape/)
* [  Error Format ](../error-format/)
* [  Usage Tips ](../usage-tips/)
* [  Versioning ](../versioning/)
* [  x402 Payments ](../x402/)
* [  Guides ](../../platform-guides/)
* [  Go To Shipp Dashboard ](https://platform.shipp.ai)

# Sport Schedule

Diving Deep?

This page is designed for AI Agents & users developing code directly. See [Getting Started](../../) and [Platform Guides](../../platform-guides/)

---

## `GET /api/v1/sports/{sport}/schedule`[¶](#get-apiv1sportssportschedule "Permanent link")

Get the upcoming Sports Schedule

Info

Games are available from 24 hours prior to now until a max of 7 days out. Not all sports go out the full 7 days, so update frequently to see what's available soon

### Path params[¶](#path-params "Permanent link")

* `sport` (required): the sport to check e.g. NBA, NFL, etc

cURLJavaScriptPython

`[](#%5F%5Fcodelineno-0-1)curl https://api.shipp.ai/api/v1/sports/nba/schedule?api_key=$api_key
`

`` [](#%5F%5Fcodelineno-1-1)const apiKey = "YOUR_API_KEY_HERE";
[](#%5F%5Fcodelineno-1-2)const url = `https://api.shipp.ai/api/v1/sports/nba/schedule?api_key=${apiKey}`;
[](#%5F%5Fcodelineno-1-3)
[](#%5F%5Fcodelineno-1-4)const response = await fetch(url, {
[](#%5F%5Fcodelineno-1-5)  method: 'GET',
[](#%5F%5Fcodelineno-1-6)  headers: {
[](#%5F%5Fcodelineno-1-7)    'Content-Type': 'application/json'
[](#%5F%5Fcodelineno-1-8)  },
[](#%5F%5Fcodelineno-1-9)});
[](#%5F%5Fcodelineno-1-10)
[](#%5F%5Fcodelineno-1-11)const result = await response.json();
 ``

`[](#%5F%5Fcodelineno-2-1)import requests
[](#%5F%5Fcodelineno-2-2)
[](#%5F%5Fcodelineno-2-3)url = "https://api.shipp.ai/api/v1/sports/nba/schedule"
[](#%5F%5Fcodelineno-2-4)api_key = "YOUR_API_KEY_HERE"
[](#%5F%5Fcodelineno-2-5)
[](#%5F%5Fcodelineno-2-6)params = {
[](#%5F%5Fcodelineno-2-7)    "api_key": api_key
[](#%5F%5Fcodelineno-2-8)}
[](#%5F%5Fcodelineno-2-9)
[](#%5F%5Fcodelineno-2-10)response = requests.get(url, params=params)
`

### Response (200)[¶](#response-200 "Permanent link")

`[](#%5F%5Fcodelineno-3-1){
[](#%5F%5Fcodelineno-3-2)  "schedule": [
[](#%5F%5Fcodelineno-3-3)    {
[](#%5F%5Fcodelineno-3-4)      "sport": "Soccer",
[](#%5F%5Fcodelineno-3-5)      "game_status": "live",
[](#%5F%5Fcodelineno-3-6)      "game_id": "01KGREKH8PXFV8AHA4Q9H2Z68F",
[](#%5F%5Fcodelineno-3-7)      "scheduled": "2026-02-06T15:00:00Z",
[](#%5F%5Fcodelineno-3-8)      "home": "Al-Ittifaq FC",
[](#%5F%5Fcodelineno-3-9)      "home_team_players": null,
[](#%5F%5Fcodelineno-3-10)      "away": "Damac FC",
[](#%5F%5Fcodelineno-3-11)      "away_team_players": null
[](#%5F%5Fcodelineno-3-12)    },
[](#%5F%5Fcodelineno-3-13)  ]
[](#%5F%5Fcodelineno-3-14)}
`

 Back to top