How to Use This Data
PadelOS offers a set of public APIs — web addresses that return your club's live data (tournaments, open matches, and more) instead of a web page. Each one works the same basic way:
The address returns data in a format called JSON — a structured format, not ready-made HTML. It isn't meant to be viewed directly, it's meant to be read by code.
Whoever builds or manages your website (a developer) fetches that address, reads the fields out of the response, and uses them to generate the HTML your visitors actually see — a name, a price, a date, and so on.
In practice, that means four steps on the developer's side:
Fetch the data — call the address and get the response back.
Parse it — convert the raw response into a usable object so individual fields can be read out of it.
Loop through the list — the data comes back as a list of items (tournaments, matches, etc.); the code goes through it one item at a time.
Build the HTML — for each item, pull out the fields you want to show and insert them into the page.
This same pattern applies to every PadelOS public API — only the address and the specific fields returned change. Below is how it works for the Tournament Listing API specifically.
About the Tournament API
This endpoint returns the tournaments currently open to the public at your club — no player login required. It's meant for clubs that want to display their tournament schedule on their own website, or pull it into another system.
The Basic Request
Every request starts from the same address, with your Club ID added on:
Replace YOUR_CLUB_ID with your club's ID, provided by PadelOS.
Example — for a club called PadelART:
Asking for More Than One Club
If you manage multiple locations and want one combined list, separate the Club IDs with a comma:
(216933 here is a placeholder for a second location — swap in your actual second Club ID.)
Narrowing the Results
You can add extra filters to the address to only show certain tournaments. Add each one after an &.
Filter | What it does |
sport | Only show one sport, e.g. sport=padel. Leave it out to show all sports. |
format | Only show tournaments of a specific format, e.g. format=doubles. |
matchType | Only show friendly or competitive tournaments, e.g. matchType=competitive. |
category / categoryIds / categoryNames | Only show tournaments linked to a specific category. Use category for the category name, or categoryIds / categoryNames to match one or more categories at once (comma-separated). |
day | Only show tournaments starting on a specific weekday, e.g. day=Saturday. |
startTime / endTime | Only show tournaments starting or ending within a time window, e.g. startTime=09:00. |
fromDate | Only show tournaments from a specific date onward, e.g. fromDate=2026-11-01. |
searchTerm | Only show tournaments whose name matches text you enter. |
rating | Only show tournaments open to players around a specific skill rating. |
availability | available shows only tournaments with open spots, slots_full shows only full ones, all shows both. Leave it out and only tournaments with open spots are shown. |
hideFilters | Hide certain tournaments from the list entirely — sold_out hides full tournaments, registration_closed hides ones that aren't open for sign-up yet. |
Example — only padel tournaments with open spots at PadelART:
https://api.padelos.co/customers/tournament/listing?clubId=216932&sport=padel&availability=available
If you enter a value a filter doesn't recognise, that one filter is simply ignored — the rest of the request still works.
Splitting Results Into Pages
If your club runs a lot of tournaments, you can ask for the list in smaller chunks instead of all at once:
limit — how many tournaments per page, e.g. limit=10.
page — which page to fetch, e.g. page=2.
Leave both out and every matching tournament comes back in one response.
What You Get Back
The response is a list of tournaments, each including:
Name, dates, start/end time, sport, and format
Whether it's a friendly or competitive tournament
The organiser(s) running it
Price, including the original price and any discount applied
The categories offered, and how many spots remain across them
Whether registration is currently open, and if not, when it opens
Any rating restriction on who can join
Sample response — showing what one tournament in the list looks like:
name: City Padel Open
clubId: 216932
clubName: PadelART
startDate: 2026-11-07
endDate: 2026-11-08
format: Doubles
matchType: Competitive
sport: Padel
price: €45 (originalPrice: €50, 10% discount applied)
remainingSlots: 6
categoryNames: ["Men's Open", "Women's Open"]
rating range: 2.0–4.5
isRegistrationOpen: true
tournamentOrganisers: Omar Haddad