💯Most important docs pages

Whether you're just getting started or refining your integration, these are the pages you’ll use most. Bookmark them, explore them, and make the most of your Sportmonks journey.

🧭 Introduction tutorial

Kickstart your Sportmonks experience. New to our API? Start here. Learn how authentication works, how endpoints are structured, and how to make your first successful request. Step-by-step guidance helps you move from your first call to confident querying.

🎯 Perfect for developers integrating Sportmonks for the first time.

Go to Introduction Tutorial →

🔧 Request Options

Shape your data, your way. Master the art of efficient requests. Learn how to filter, sort, paginate, and include related data without unnecessary overhead. Build smaller, faster, and more precise responses.

⚙️ Essential for performance-focused applications.

Explore Request Options →

📁 Demo Response Files

See it before you build it. Preview actual JSON responses for fixtures, teams, players, and standings. These files are ideal for planning data models, front-end components, or testing integrations before going live.

🧩 Useful for developers designing data structures and prototypes.

View Demo Files →

✅ Best Practices

Build smarter and scale confidently. Avoid common pitfalls with expert guidance on topics like caching, rate-limiting, timezone handling, and database synchronisation. These principles ensure your integration remains stable and efficient as you grow.

🛠 Highly recommended for production setups.

Read Best Practices →

📚 Guides Collection (incl. Components Guide)

Go beyond the basics. Explore structured tutorials packed with real examples. Learn how to build modular and reusable data structures with the Components system, and how to combine endpoints effectively.

📘 For developers expanding from simple requests to advanced builds.

Browse Guides →

🔄 States

Track every match’s lifecycle. Understand how fixture states define the timeline of a match — scheduled, live, halftime, finished, or cancelled. Use them to power live dashboards and notifications with real-time accuracy.

⏱ Key for live-score and timeline applications.

Learn about States →

⚡ Events

Follow every key moment. Events capture the action: goals, cards, substitutions, and more. Learn how to include and interpret them to build detailed match feeds, commentary systems, and visual timelines.

🎯 Ideal for match trackers and live commentary widgets.

Read Events Docs →

📊 Statistics

Turn data into insight. Dive deep into performance metrics like shots, passes, possession, and expected goals. Use this data to fuel analytics dashboards, fantasy scoring, and predictive models.

📈 Perfect for analytics, scouting, and performance tools.

Explore Statistics →