Get all galleries

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

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

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_galleries.sh

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

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

   get_all_galleries_response.json

   [
     {
       "gallery_name": "Ceremony Photos",
       "picture_count": 125,
       "is_visible": true,
       "url": "https://gallery.fstop.com/ceremony-photos",
       "created_at": "2026-05-21T10:35:00Z"
     },
     {
       "gallery_name": "Picnic Photos",
       "picture_count": 89,
       "is_visible": false,
       "url": "https://gallery.fstop.com/picnic-photos",
       "created_at": "2026-05-20T14:20:00Z"
     }
   ]

2. Using the Python SDK:

   get_all_galleries.py

   from fstop import Fstop
   
   with Fstop(jwt_auth="YOUR_ACCESS_TOKEN") as f_client:
       galleries = f_client.galleries.list_galleries()
   
       for gallery in galleries:
           print(f"{gallery.gallery_name} - {gallery.picture_count} photos")

You can use the data from the GET request in your application. For example, you could display a list of all galleries or filter galleries by visibility status.

What to do next

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