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?]
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]
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. | |
| name | No | The team name, or part of it, e.g. "Hawks". At least two letters. Used with what: find_team. | |
| team | No | A team, by name. Leave out for the person's own team. Used with what: head_to_head, team_dues_status. | |
| 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, 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. | |
| 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. | |
| 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. | |
| 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. | |
| 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. | |
| tournament_id | No | A tournament id, from what "tournaments". Used with what: tournament_draws, tournament_court_schedule, team_chat, tournament_photos, tournament_highlights, referee_assignments. |