Home / Documentation / API Reference

🔌 API Documentation

Integrate Sports Buddies into your applications with our comprehensive REST API

🚀 Getting Started

Get up and running with the Sports Buddies API in minutes. Our RESTful API provides access to all platform features including user management, matching, messaging, and events.

Authentication

Learn how to authenticate your API requests using OAuth 2.0 and API keys.

View Guide

Quick Start

Step-by-step guide to make your first API call and get user data.

Get Started

SDKs & Libraries

Official SDKs for JavaScript, Python, iOS, and Android development.

View SDKs

🔗 Core Endpoints

Essential API endpoints for building Sports Buddies integrations.

STABLE

Users & Profiles

Manage user accounts, profiles, and preferences through our comprehensive user API.

  • User registration and authentication
  • Profile management and updates
  • Sports preferences and skill levels
  • Privacy settings and controls
View Endpoints
STABLE

BuddyMatch™ Algorithm

Access our advanced matching algorithm to find compatible sports buddies.

  • Get personalized match recommendations
  • Filter by sport, skill level, and location
  • Compatibility scoring and ranking
  • Match history and analytics
View Endpoints
STABLE

Messaging & Communication

Enable real-time messaging and communication between users.

  • Send and receive messages
  • Group conversations and threads
  • Message history and search
  • Push notifications
View Endpoints
STABLE

Events & Activities

Create, manage, and discover sports events and activities.

  • Event creation and management
  • RSVP and attendance tracking
  • Event discovery and search
  • Location-based recommendations
View Endpoints

⚡ Advanced Features

Advanced API capabilities for sophisticated integrations.

BETA

Analytics & Insights

Access detailed analytics and insights about user behavior and platform usage.

View Endpoints
BETA

Webhooks

Receive real-time notifications about events and user activities.

View Endpoints
ALPHA

AI-Powered Features

Access our AI-powered safety monitoring and content moderation features.

View Endpoints

💻 Code Examples

Quick examples to help you get started with common API operations.

Get User Profile

curl -X GET "https://api.joinsportsbuddies.app/v1/users/me" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json"

Find Matches

curl -X POST "https://api.joinsportsbuddies.app/v1/matches/find" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "sports": ["basketball", "tennis"], "skill_level": "intermediate", "max_distance": 25 }'

📊 Rate Limits & Pricing

Understand our API rate limits and pricing structure.

Rate Limits

  • Free Tier: 1,000 requests per hour
  • Pro Tier: 10,000 requests per hour
  • Business Tier: 100,000 requests per hour
  • Enterprise: Custom limits available

Pricing

  • Free Tier: $0/month - Basic API access
  • Pro Tier: $49/month - Enhanced limits & support
  • Business Tier: $199/month - Advanced features
  • Enterprise: Custom pricing - Dedicated support

🆘 Support & Resources

Get help and access additional resources for your API integration.

API Status

Check the current status of our API services and any ongoing issues.

Check Status

Developer Support

Get help from our developer support team for technical questions.

Contact Support

Community Forum

Connect with other developers and share integration experiences.

Join Forum

Explore More Documentation

Discover other helpful guides and resources to get the most out of Sports Buddies.

🎯 Getting Started

Learn the basics of Sports Buddies, create your profile, and make your first connection.

Quick Start Guide Profile Setup Making Connections App Navigation

📱 User Guides

Master all the features and learn how to get the most out of Sports Buddies.

BuddyMatch™ Algorithm Messaging & Communication Events & Meetups Notifications & Settings

🛡️ Safety & Trust

Learn about our PlaySafe™ features, verification process, and how we protect our community.

VerifiedPlayer™ ID Verification PlaySafe™ Safety Features Reporting Issues ShowScore™ Rating System

🤝 Community

Understand our community guidelines, moderation policies, and how to be a great community member.

Community Guidelines Moderation Policies Best Practices Community Events

⚙️ API & Developers

Technical documentation for developers, integrations, and API access.

API Overview Authentication API Endpoints Webhooks

❓ Help & Support

Find answers to common questions and get help when you need it.

Frequently Asked Questions Troubleshooting Contact Support Send Feedback

📋 Policies

Read our terms of service, privacy policy, and other important legal documents.

Terms of Service Privacy Policy Community Standards Data Usage Policy