Skip to main content

Web URL Guide

Reference guide for how to build and customize web URLs

Written by Haris K

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

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.

Did this answer your question?