Developer Docs

API Documentation

RESTful API endpoints for accessing Scrumbase rugby data. Access player profiles, match results, live scores, standings, and team information programmatically.

Getting Started

Base URL

https://scrumbase.app/api

Authentication

Public read-only endpoints are available without authentication. Write operations and premium data feeds require an API key issued through our Data Partnership program.

Response Format

All responses are JSON. Successful responses return 200 with data. Errors return the appropriate HTTP status code with an error message.

Endpoints

GET/api/players

Browse player profiles with pagination and filters

Parameters

pagelimitsearchpositionteam
GET/api/matches

View match results and fixtures

Parameters

statuscompetitiondate
GET/api/matches/:id/events

Get all events for a match

GET/api/teams

List all teams

Parameters

typesearch
GET/api/news

Get latest rugby news articles

Parameters

limitpagecategorysearch
GET/api/standings

Get league standings and tables

Parameters

leagueseason

Example Response

GET /api/players

{
  "success": true,
  "data": [
    {
      "id": "1",
      "firstName": "Jeff",
      "lastName": "Kiragu",
      "position": "Fly-half",
      "team": "Kenya Harlequin",
      "age": 28,
      "caps": 45,
      "status": "active"
    }
  ],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 1247,
    "totalPages": 25
  }
}

Rate Limits & Best Practices

  • Rate limit: 100 requests per minute per API key
  • Use pagination for large datasets (limit 50–100 records per request)
  • Cache responses where appropriate to reduce API calls
  • Handle errors gracefully using the returned HTTP status codes

Premium Data & API Licensing

Interested in real-time data feeds, premium analytics, or Scout access? Explore our partnership program.

View Partnerships