# Sports schedules

Best for: One day of games for the NFL, NBA, MLB, NHL and major soccer leagues. Category: Events and tickets.

One league-day of games: teams, start time, venue name, city and country, indoor flag, status and attendance on completed games. MLB adds stadium capacity and coordinates.

- Look up by: A league code (nfl, nba, mlb, nhl, epl and others) and a day; empty means the current day or week
- Coverage: NFL, NBA, MLB, NHL and major soccer leagues
- Cost: 1 credit a call; failed and empty calls are free
- Answers: Search

## Endpoints

- `POST /v1/events/sports/schedule`: Sports schedule, 1 credit. https://scrapercompany.com/docs/reference/sports-schedule

## Example

Sports schedule (`POST /v1/events/sports/schedule`):

```bash
curl -X POST "https://api.scrapercompany.com/v1/events/sports/schedule" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "league": "string"
  }'
```

## Good to know

- 1 credit a league-day; a day with no games is free.

- [All data sources](https://scrapercompany.com/docs/data-sources)
