API Documentation

Complete guide to integrating the Ruley API into your application.

Quick Start

Get started with the Ruley API in minutes

1. Get your API key

2. Make your first request

curl -X POST https://api.ruley.ai/chat/pickleball \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What is the kitchen rule in pickleball?",
    "previousMessages": []
  }'

Try It Out

Test the API directly from your browser

Sport

Pick the sport your question is about. Try It uses the portal proxy; FlingGolf is sent to /chat/golf with ruleset: FlingGolf.

API Key

Message

API Endpoints

POST/chat/{sport}

Get rule interpretations for specific scenarios. The sport is specified in the URL path.

URL Parameters:

sport (string, required): pickleball, padel, tennis, intennse, soccer, golf, flinggolf, kickball. For FlingGolf, call /chat/golf with ruleset in the body (see below).

Headers:

X-API-KEY (string, required): Your API key
Content-Type (string, required): application/json

Request Body:

message (string, required): The rules question
previousMessages (array, optional): Previous conversation messages for context
ruleset (string, optional): For /chat/golf, send FlingGolf for FlingGolf or omit for USGA regulation golf.

Supported Sports