What This Screen Does

This screen shows you a log of every time someone used (or tried to use) a door access point at your facility. Think of it like a visitor logbook at the front desk — except it is automatic and records every single entry attempt. You can see who accessed the door, when they did it, which device was used, and whether the attempt was successful or not.

How to Get There

Open the dashboard.
In the left-hand menu, click Door Access.
You are now on the Door Access List screen.

Step-by-Step Guide

At the top of the page you will see a breadcrumb trail: Dashboard > Door Access > List.
You can click Dashboard to go back to the main dashboard, or Door Access to return to the door access section root.

2. Use the Status Tab to Filter

Below the breadcrumbs there is a tab bar with a single All tab.
The All tab displays a badge showing the total number of door access records.
Click the All tab to view every record (this is selected by default).

3. Read the Door Access Table

The table displays all door access events. Each row is one access attempt. Here are the columns:

Column	What It Shows
Timestamp	The exact date and time the access attempt happened.
Member	The name, profile photo, and email address of the person who attempted access. Click the name or avatar to go to that member’s profile.
Device ID	The identifier of the physical door device that was used.
External ID	An external reference ID from the door access system.
Status	Whether the access attempt succeeded, failed, timed out, or is unknown.

4. Understand the Status Indicators

Each row has a colored status chip in the Status column:

Status	Color	What It Means
Succeeded	Green	The person successfully opened the door.
Failed	Red	The access attempt was denied. Hover over the chip to see the reason.
Timeout	Yellow/Orange	The door system did not respond in time.
Unknown	Red	The system could not determine what happened.

5. Sort the Table

Click any column header to sort the table by that column.
The table is sorted by Timestamp in descending order (newest first) by default.
Click the same column header again to reverse the sort direction.

6. View a Member’s Profile

Click on a member’s avatar or name in the Member column.
You will be taken to that member’s detail page where you can see their full profile.

7. Adjust Pagination

At the bottom of the table you will find pagination controls.
Change the rows per page to show more or fewer records at once.
Use the page navigation arrows to move between pages.
Toggle Dense mode to make the rows more compact and fit more data on the screen.

What Happens Behind the Scenes

You open the Door Access List screen
        |
        v
System reads the currently selected gym
        |
        v
API call: GET /api/door-access
  (with page number, page size, sort column, and sort direction)
        |
        v
Server returns a list of door access records
  and a total count in the response headers
        |
        v
Table displays the records
        |
        v
(When you change page, page size, sort, or selected gym)
The API call repeats automatically with the new parameters
        |
        v
Table updates with the new data

Troubleshooting

“The table is empty and I expected to see records”

Make sure you have the correct gym selected in the global gym picker at the top of the dashboard. Door access records are filtered by the currently selected gym.
If you recently set up door access, it may take a moment for the first records to appear. Try refreshing the page.

“I see a ‘Failed’ status but I do not know why”

Hover your mouse over the red Failed chip. A tooltip will appear showing the error message from the door system.
Common reasons include: the member’s membership has expired, they do not have door access privileges on their membership type, or the door system encountered a hardware error.

“The member column shows a blank name or no photo”

This can happen if the member’s profile is incomplete or if the access attempt was made by someone whose account has since been deleted.
Check the External ID column — you may be able to look up the person in your external door system using that ID.

“I cannot find a specific access event”

The table defaults to showing the most recent events first. Use the pagination controls at the bottom to navigate to older records.
If you are looking for events from a long time ago, increase the rows per page to see more records at once and page through them.
Currently there is no search or date filter on this screen. You need to page through the results or sort by a different column to find what you need.

“The page is loading very slowly”

If you have a large number of door access records, the page may take a moment to load. Try reducing the rows per page to a smaller number (e.g., 5 or 10) for faster loading.
Check your internet connection. The data is fetched from the server each time you change pages or sorting.

“I changed the selected gym but the data did not update”

The table should refresh automatically when you change the selected gym. If it does not, try refreshing the page manually.
Make sure the new gym has a door access system configured. If no door system is set up for that gym, the table will be empty.

“I see a ‘Timeout’ status — what should I do?”

A timeout means the door system did not respond quickly enough. This is usually a temporary network or hardware issue.
If you see many timeouts in a row, contact your door system provider or check that the door hardware is powered on and connected to the internet.