Look something up
beleeg_look_upLook something up in the person's Beleeg leagues. Read-only: nothing changes. Pick what, give only the params listed for it (league_id comes from beleeg_whoami), and relay the answer as written — times already carry their time zone. For what needs the person across all their leagues use beleeg_needs_me; for public pages by slug use beleeg_look_up_public.
what (params; ? = optional):
my_leagues: The leagues the person belongs to, their roles in each, and each league_id. [no params]
league_brief: A whole league in one call: teams with captains and roster sizes, standings, the schedule by week, recent results, tournaments. Best for broad questions. [league_id]
search_leagues: The public league directory, by name, sport or town — for leagues the person is not in. [query?]
standings: The standings table: rank, record, points, streak, last five, games back. [league_id, season_id?]
schedule: This season's matches, earliest first: date and time with zone, venue, sides, score; the match ids changes take. [league_id, from_date?, to_date?, team_id?, limit?]
divisions: The league's divisions and their ids. [league_id, season_id?]
seasons: Every season the league has run, newest first, with ids and dates. [league_id]
makeup_options: Days a rained-out or postponed match could be replayed on, and what each costs (league admins). [league_id, from_date?, match_ids?, horizon_days?]
teams: Every team in the league with its captain and roster user ids. [league_id, limit?]
members: Everyone in the league — name, email, roles, status — plus invites not yet accepted. [league_id, limit?]
my_team_assignment: The person's own team, line and role, as their captain set it. [league_id]
unpaid_members: Members who still owe the registration fee (league admins). [league_id]
tournaments: Every tournament the league has run or planned, with ids. [league_id, limit?, cursor?]
tournament_draws: The parallel draws (brackets) inside one tournament. [tournament_id, limit?]
tournament_court_schedule: One tournament's order of play: court, start time and referee per match. [tournament_id, limit?]
team_chat: Recent messages in a team's chat (people on the team only). [team_id, limit?, tournament_id?]
comms_status: Announcements already emailed to the league: subject, when, to whom, how many got it (league admins). [league_id, limit?]
articles: The league's published news posts and match recaps. [league_id, limit?, cursor?]
article_comments: Comments on one article or recap. [article_id, limit?]
tournament_photos: Photos uploaded for a tournament. [tournament_id, limit?]
tournament_highlights: Video highlights uploaded for a tournament. [tournament_id, limit?]
highlight_comments: Comments on one video highlight. [highlight_id, limit?]
tournament_referee_assignments: A tournament's referee assignments: match, court, time, referee. [tournament_id, limit?]
my_referee_alerts: How the calling referee is set up to hear about assignments. [no params]
my_availability: The person's own availability windows (an admin may name a user_id). [user_id?]
demo_league: Diagnostic snapshot of the demo league (Beleeg platform administrators only). [no params]
match_availability: Who can make a league match: each side's players grouped In, Out, Maybe and Hasn't answered. [league_id, match_id?]
match_checklist: The league's checklist for one match (the things every match needs — shot clock operator, snacks, nets put away) and who has answered what. [league_id, match_id?]
head_to_head: A team's record against one opponent in this league, across every season: won, lost, drawn, the total score, and the most recent results. [league_id, opponent, team?]
match_venue: Where a match is and what to know before going: the venue and its address with a map link, where to park, how to find the courts or field, what time to arrive by and what to wear, as the league set them. [league_id, match_id?]
calendar_link: The person's own calendar link: every match for every team they play on, which their phone or computer calendar keeps up to date by itself — a moved match moves in their calendar too. [no params]
match_proposals: Open requests to move a match that involve the person: ones waiting on them to accept, decline or approve, and ones their team is waiting on. [league_id]
standings_form: Each division's table this season with form: record, current streak (W3 = three wins in a row), last five results, and games behind the leader. [league_id]
find_team: Find a team by name across every league on Beleeg that lists itself publicly: its league, division, season, town, and a link to its public page (schedule, results, and a calendar anyone can subscribe to). [name]
open_disputes: Scores in dispute in this league: the match, the score one team put in, and the other team's reason. [league_id]
player_stats: Players' records this season, best first: matches won and lost, win percentage, and sets won and lost where the sport has sets. [league_id, player?]
team_dues_status: A team's dues (the kitty the captain collects): what they are for, how much, who has paid and who still owes. [league_id, team?]
scheduled_emails: League emails set to go out later: the subject, when each goes out (in the league's time), who it goes to, and any that could not be sent. [league_id]
referee_availability: The league's referees for one day: who is free, who already referees a match that day (and which), and who took the day off. [league_id, match_id?, date?]
events: Upcoming social events for this league and its organization: when, where, how many are going or maybe, spots left, the ticket price, and the person's own answer. [league_id, event?]
sponsors: The league's sponsors: applications waiting for an answer (who, what tier, what they offer), who is showing now, and how many were declined. [league_id]
store: The league store, read only: what is for sale and at what price, what is hidden, and the latest orders (who, what, total, status). [league_id]
waitlist: The league's waiting list in order (who, since when, who was already offered a spot) and how many spots are open now. [league_id]
ladder: The league's challenge ladder: every spot in order with each side's wins and losses, the challenges going on (who challenged whom, the answer deadline, the agreed time and place), any challenge waiting on the person's answer with its deadline, and who they… [league_id]
money_summary: The league's registration money: how many of the registered members have paid, about how much has been collected (paid × the registration fee; refunds and discounts are not counted), how many still owe, and invites not yet accepted. [league_id]
change_history: The league's latest changes, newest first: what changed, who changed it (or that it happened automatically) and when — people added or given a role, teams added or renamed, matches scheduled or moved, lineups sent or approved, settings changed. [league_id, kind?, days?]
org_members: Find people by name across the organizations the person runs (owners and organization admins only): each match with their organization role (owner, organization admin, billing manager or member) and the leagues they are in, so two people with the same name… [name, organization?]
my_next_match: The person's next match in every league they play in (or just one league), soonest first: when, who against, where. [league_id?]
my_lineup_spot: Where the person plays in their team's lineup for a match (spot number and who with), or that the captain has not set it yet, or that they are not in it. [league_id, match_id?]
registration_status: Whether the person is signed up for a league, which team, whether their registration is paid and whether they still owe the sign-up agreement; for someone not in it (an open public league), whether sign-up is open, the fee, spots left and their waiting-list… [league_id]
my_invites: Invitations to leagues waiting for the person's email: which league, what as (player, captain, referee…), which team, from whom. [no params]
connected_apps: The apps and AI assistant connections the person has connected to their account (what each can do, when last used). [no params]
referee_assignments: A referee's upcoming assignments across every league, each with whether they accepted, declined or still need to answer. [no params]
referee_pay: What a referee is owed (each match and league) and what they have been paid this year. [no params]
whos_checked_in: Players whose player pass was scanned in, with the time, for one match or for today. [league_id, match_id?]
recaps_due: Final results in this league that nobody has written a recap for yet, newest first. [league_id]
lebrain_questions: For league admins: how many members asked lebrAIn things in this league lately, what they asked for most, and their recent questions. [league_id, days?]
team_polls: The polls on the person's team: each question, the votes for each choice, whether it is still open and what the person voted. [league_id, team?]
sub_requests: Teams in this league looking for a sub right now: which match, any note, and — for the team's own captain — who has offered. [league_id]
org_whats_waiting: For organization owners and admins: what needs them across their organization — join requests, reported messages, sponsors waiting, unpaid registrations, unread chats, and each league's to-dos. [organization?]
org_settings: For organization owners and admins: how the organization is set up — logo and color, league chat, social events, the public list of its leagues. [organization?]
org_sponsors: For organization owners and admins: the organization's sponsors, which are waiting for an answer, paused or showing, and how often each was seen and clicked. [organization?]
league_videos: The league's videos, newest first (titles), and the address of its Videos page — or only one team's (team) or one match's (matchId). [league_id, team?, match_id?]
podcast_episodes: The league's podcast episodes, newest first: title, when it came out and how long it runs, and the address of its Podcast page. [league_id]
league_rules: The rules the league posted (its Rules page, in its own words) and its lineup rules in plain words (rating order, line changes, how many women). [league_id]
my_court_this_week: The person's court-ladder court this week: the day, the club and its address, the court number, the four (or five) players with their positions, the person's own position, whether the scores are in and who may enter them, and when they are due. [league_id]
court_ladder_standings: The court ladder in order: each player's place, their court this week, games so far this week, last week's move (up, down or stayed), shared-spot partners, and the PTI as entered. [league_id, season?]
sub_list: The court ladder's list of people ready to fill in: each name with their PTI, phone and email, and any note (e.g. [league_id]
court_ladder_week: One court-ladder week at a glance: how many are in, out (and how many found a sub) and haven't answered, the courts, and the one next step. [league_id, week_number?]
my_changes: Changes an assistant prepared or made for this person, and whether their emails actually went out. [limit?]
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | The day, as YYYY-MM-DD, when no match is named. Used with what: referee_availability. | |
| days | No | How many days back to look (1-365). Defaults to 30. Used with what: change_history, lebrain_questions. | |
| kind | No | Only one kind of change. Omit for everything. Used with what: change_history. | |
| name | No | The team name, or part of it, e.g. "Hawks". At least two letters. Used with what: find_team, org_members. | |
| team | No | A team, by name. Leave out for the person's own team. Used with what: head_to_head, team_dues_status, team_polls, league_videos. | |
| what | Yes | What to look up. Every value is listed, with its params, in the tool description. | |
| event | No | A word or two from one event's name, to see who is coming. Used with what: events. | |
| limit | No | Most rows to return. A list that is cut short says how many were left out. Used with what: schedule, teams, members, tournaments, tournament_draws, tournament_court_schedule, team_chat, comms_status, articles, article_comments, tournament_photos, tournament_highlights, highlight_comments, tournament_referee_assignments, my_changes. | |
| query | No | Words to match against league name, organization, sport, or town. Omit to list everything public. Used with what: search_leagues. | |
| cursor | No | Opaque cursor from a previous page; leave out for the first page. Used with what: tournaments, articles. | |
| player | No | One player by name, or "me". Omit for the top ten. Used with what: player_stats. | |
| season | No | true for the season totals and awards instead of this week. Used with what: court_ladder_standings. | |
| team_id | No | Only matches involving this team. Used with what: schedule, team_chat. | |
| to_date | No | Only matches on or before this day, YYYY-MM-DD. Used with what: schedule. | |
| user_id | No | Target user. Omit to return the calling user's own availability. Used with what: my_availability. | |
| match_id | No | One match id (from what "schedule"). For the match-day lookups, leave out to mean the person's next match. Used with what: match_availability, match_checklist, match_venue, referee_availability, my_lineup_spot, whos_checked_in, league_videos. | |
| opponent | No | The other team, by name, e.g. "Hawks". Used with what: head_to_head. | |
| from_date | No | Only matches on or after this day, YYYY-MM-DD. Omit for the whole season. Used with what: schedule, makeup_options. | |
| league_id | No | The league id, from beleeg_whoami or what "my_leagues" (what "search_leagues" for a league the person is not in). Used with what: league_brief, standings, schedule, divisions, seasons, makeup_options, teams, members, my_team_assignment, unpaid_members, tournaments, comms_status, articles, match_availability, match_checklist, head_to_head, match_venue, match_proposals, standings_form, open_disputes, player_stats, team_dues_status, scheduled_emails, referee_availability, events, sponsors, store, waitlist, ladder, money_summary, change_history, my_next_match, my_lineup_spot, registration_status, whos_checked_in, recaps_due, lebrain_questions, team_polls, sub_requests, league_videos, podcast_episodes, league_rules, my_court_this_week, court_ladder_standings, sub_list, court_ladder_week. | |
| match_ids | No | Specific matches instead of a whole day. Give this or from_date. Used with what: makeup_options. | |
| season_id | No | A past season, from what "seasons". Leave out for the season being played now. Used with what: standings, divisions. | |
| article_id | No | Article whose comments to list. Used with what: article_comments. | |
| week_number | No | Which week (1, 2, 3…). Omit for the current week. Used with what: court_ladder_week. | |
| highlight_id | No | Highlight whose comments to list. Used with what: highlight_comments. | |
| horizon_days | No | How far ahead to look. Default 45 days. Used with what: makeup_options. | |
| organization | No | Only this organization (its name). Omit for every organization they run. Used with what: org_members, org_whats_waiting, org_settings, org_sponsors. | |
| tournament_id | No | A tournament id, from what "tournaments". Used with what: tournament_draws, tournament_court_schedule, team_chat, tournament_photos, tournament_highlights, tournament_referee_assignments. |