Get all bookings

The Fstop API includes an endpoint that allows client applications to retrieve all bookings from the database.

In this guide, you’ll make a GET request to the /api/bookings/ endpoint to retrieve a list of all bookings.

Before you begin

Before you make a GET request, ensure that you have an access token. For instructions on requesting an access token, see Getting started with the Fstop API.

Make a GET request

1. Open a terminal and run the following command:

   get_all_bookings.sh

   curl -X GET http://localhost:8000/api/bookings/ \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

   The API returns a 200 OK and a list of all bookings:

   get_all_bookings_response.json

   [
     {
       "id": "dfeca3aa-31f3-4d79-a487-62ea612a6875",
       "project": {
         "id": "5e0c74ea-9962-450b-8ec8-af460a5fe976",
         "project_name": "Birthday Party",
         "project_type": "party",
         "client": {
           "id": "7c709f54-7a18-4f10-8a3e-8e4cb9bb8242",
           "first_name": "Alice",
           "last_name": "Johnson",
           "city": "Cincinnati",
           "state": "OH",
           "zip_code": "45202",
           "email": "alice.johnson@example.com",
           "phone_number": "+12161239999",
           "created_at": "2026-05-25T01:05:46.189023Z"
         },
         "created_at": "2026-05-25T01:37:46.765601Z"
       },
       "date": "2026-07-12",
       "time": "14:00:00",
       "duration": 480,
       "location": "Downtown Venue",
       "created_at": "2026-05-25T01:51:08.333028Z"
     },
     {
       "id": "a4b9da24-da9b-444e-ab30-0f9a65489886",
       "project": {
         "id": "cc0dd84d-a50d-4ad5-8e94-e9dcb33d00e3",
         "project_name": "Bob's Birthday Party",
         "project_type": "party",
         "client": {
           "id": "88e0de45-8197-4425-a390-3401348cc0bb",
           "first_name": "Bob",
           "last_name": "Barker",
           "city": "New York",
           "state": "NY",
           "zip_code": "07008",
           "email": "bob.barker@gmail.com",
           "phone_number": "+12126885200",
           "created_at": "2026-05-21T01:23:38.570263Z"
         },
         "created_at": "2026-05-21T01:30:04.766552Z"
       },
       "date": "2026-07-12",
       "time": "14:00:00",
       "duration": 480,
       "location": "Downtown Venue",
       "created_at": "2026-05-25T02:00:45.998094Z"
     }
   ]

2. Using the Python SDK:

   get_all_bookings.py

   from fstop import Fstop
   
   with Fstop(jwt_auth="YOUR_ACCESS_TOKEN") as f_client:
       bookings = f_client.bookings.list_bookings()
   
       for booking in bookings:
           print(f"{booking.project.project_name} - {booking.date} at {booking.time}")

You can use the data from the GET request in your application. For example, you could display a calendar of all bookings or filter bookings by date.

What to do next

See GET /api/bookings/ for a full list of request parameters and response schemas.