This is a reference guide for building and customizing PadelOS player app URLs, using Padel Powers as the example. It covers company and club setups, how to filter by club location, set the language, link to specific sections (bookings, open matches, events, tournaments, trainings, private lessons), open a page with filters already set, and open the registration form directly, including with a pre-filled email.
Example Setup: Padel Powers
Padel Powers has one company and three locations in the Czech Republic.
Company ID: 217
Location | Club ID |
Prague Smíchov | 216927 |
Brno Kravi Hora | 216928 |
Brno Slatina | 216930 |
Company page: https://player.padelos.co/company/217
Club page (Brno Kravi Hora): https://player.padelos.co/club/216928
Company page vs. club page
Company page: for companies with multiple locations. It shows the combined content from all the locations together. The number in the link is the company ID (217 in this example).
Club page: a link that loads the content for one individual location only. The number in the link is that location's club ID (216928 for Brno Kravi Hora in this example).
Company Setup and Club Setup
Some companies run all their locations from one company page. Others run each location as its own club, with its own page. This setup decides how every link starts:
Company setup: links start with the company, such as company/217, and cover all its locations. Players switch between locations on the page, and you can pick locations with clubIds.
Club setup: each location has its own links, starting with its club ID, such as club/216928. Players stay on that club's page, and clubIds does not apply.
To check which setup a club uses, open its player app. If the address shows /company/, use the company setup links. If it shows /club/, use the club setup links.
The examples below use Padel Powers for both setups.
Available Parameters
You can customize the URL in six ways:
clubIds: filter by location (company setup only)
locale: set the language
auth=register: open the registration form directly
format: pre-set a tournament type (tournaments only)
type: open a specific tab on the Events or Trainings page
filters: open a page with filters already set, such as a sport, date or time
Selecting a Location
This applies to the company setup only.
One club: add clubIds to the URL.
Multiple clubs: separate the IDs with commas.
Setting a Language
Language | Parameter |
English | locale=en |
Czech | locale=cs |
Example, company page in English:
Example, club setup in Czech:
Combining Parameters
Use ? before the first parameter, and & before each additional one.
Example, Brno Kravi Hora in English:
Example, Brno Kravi Hora in Czech:
Section-Specific URLs
Link directly to a section for a specific club, for either setup:
Section | Company setup | Club setup |
Home | company/217?clubIds=216928 | club/216928 |
Bookings | company/217/bookings?clubIds=216928 | club/216928 (the club page opens on bookings) |
Open matches | company/217/openMatches?clubIds=216928 | club/216928/openMatches |
Events and Trainings Pages
Some clubs have one Events page and one Trainings page in their menu, each with tabs. Others list each section on its own. This depends on the club's settings, so check the club's menu before you share a link. Link to the pages players see there.
Clubs with the Events and Trainings pages:
Section | Company setup | Club setup |
Events (events and tournaments) | company/217/allEvents?clubIds=216928 | club/216928/allEvents |
Trainings (trainings and private lessons) | company/217/allTrainings?clubIds=216928 | club/216928/allTrainings |
Clubs with separate sections:
Section | Company setup | Club setup |
Events | company/217/events?clubIds=216928 | club/216928/events |
Trainings | company/217/trainings?clubIds=216928 | club/216928/trainings |
Tournaments | company/217/tournaments?clubIds=216928 | club/216928/tournaments |
Private lessons | company/217/private-sessions/trainers-slots?clubIds=216928 | club/216928/private-sessions/trainers-slots |
Every link in these tables opens for every club. The club's settings only decide which pages appear in its menu.
Events and Trainings: Opening a Specific Tab
The Events and Trainings pages have tabs. Add a type parameter to open the page on a specific tab. Without it, the page opens on the first tab.
Page | Tab | Parameter |
Events | Events | type=event |
Events | Tournaments | type=tournament |
Trainings | Trainings | type=training |
Trainings | Private lessons | type=private_lesson |
Example, tournaments at Brno Kravi Hora:
Example, private lessons in a club setup:
Tab names can follow the club's own wording. Padel Powers, for example, calls its trainings tab "Lessons". The parameter values stay the same.
Filters
Most pages have filters, such as sport, date or time. Add them to a link and the page opens with those filters already set. Players can still change them on the page.
Filters follow the same combining rule as other parameters: ? before the first parameter, & before each additional one. Each filter works only on the pages listed for it below.
Writing Filter Values
Every filter value is written the same way:
Value | How to write it | Example |
Date | Year-month-day | 2026-10-25 |
Time | 24-hour clock | 18:00 |
Several values | Separated by commas | male,mixed |
Names, such as a sport, court type or category | As shown in the app, with each space written as %20 | Padel |
Trainer | The trainer's ID: the number at the end of their profile page address | 71224 |
Bookings
On the booking page, and on the club page in a club setup, which opens on bookings:
Filter | What it shows | Values |
sport | One sport | A sport the club offers, such as padel |
date | The day to open on | A date |
duration | Bookings of one length, in minutes | A length the club offers, such as 90 |
courtType | Courts of one type | A court type, such as Indoor (several allowed) |
courtSize | Courts of one size | A court size, such as Double (several allowed) |
courtFeatures | Courts with a feature | A feature, such as Panoramic (several allowed) |
Example, 90-minute padel bookings at Brno Kravi Hora on 25 October:
Example, the same in a club setup:
Open Matches
On the open matches page:
Filter | What it shows | Values |
sport | One sport | A sport the club offers, such as padel |
date | The day to open on | A date |
gender | Who can join | all, male, female or mixed (several allowed) |
day | One day of the week | Monday to Sunday |
startTime | Matches starting at or after a time | A time |
endTime | Matches finishing at or before a time | A time |
rating | Matches open to a given rating | A number, such as 3.5 |
availability | Whether full matches show | available (default), slots_full or all |
Example, mixed matches at Brno Kravi Hora:
Example, evening matches in a club setup:
Events, Trainings and Tournaments
On the Events and Trainings pages, and on the separate events, trainings and tournaments sections. Some filters belong to one kind of activity only:
Filter | What it shows | Values |
sport | One sport | A sport the club offers, such as padel |
day | One day of the week | Monday to Sunday, or Daily |
startTime | Sessions starting at or after a time | A time |
endTime | Sessions finishing at or before a time | A time |
category | One category | A category name, as shown in the listing |
rating | Sessions open to a given rating | A number, such as 3.5 |
availability | Whether full sessions show | available (default), slots_full or all |
trainerId | Trainings only: one trainer's sessions | A trainer ID |
format | Tournaments only: one format | See Tournaments: Pre-Setting the Format |
division | Tournaments only: one division | all_double, mens_double or womens_double |
matchType | Tournaments only: competitive or friendly | competitive or friendly |
Example, Saturday events at Brno Kravi Hora:
Example, Thursday tournaments from 17:00 at Brno Kravi Hora:
Example, Monday trainings in a club setup:
Private Lessons
On the Private lessons tab of the Trainings page, and on the separate private lessons section:
Filter | What it shows | Values |
sport | One sport | A sport the club offers, such as padel |
date | The day to open on | A date |
duration | Lessons of one length, in minutes | A length the club offers, such as 60, 90 or 120 |
trainerId | One trainer's lessons | A trainer ID |
Example, 90-minute private lessons at Brno Kravi Hora on 27 October:
Example, the same in a club setup:
Example, the same on the separate private lessons section:
Tournaments: Pre-Setting the Format
For tournaments, you can add a format parameter to open the page with a specific tournament type already selected, for example Americano. This works on the Tournaments section and on the Tournaments tab of the Events page.
Example, Americano tournaments at Brno Kravi Hora:
Example, Americano tournaments on the Events page:
Example, the same in a club setup:
This follows the same combining rule as other parameters: ? before the first parameter, & before each additional one.
Registration Form
Open the registration form company-wide:
Pre-fill the player's email address:
Registration form for a specific club:
Location | URL |
Prague Smíchov | club/216927?auth=register |
Brno Kravi Hora | club/216928?auth=register |
Brno Slatina | club/216930?auth=register |
To pre-fill the email, add &email=[email protected] to any of the above.
Use these links in a club setup. In a company setup, use the company-wide link above: the form asks the player to choose their home club.
Note
If the player is already logged in, the registration form will not open. They will see a message confirming they are already signed in.