Get a client

The Fstop API includes an endpoint that allows client applications to retrieve a specific client by ID.

In this guide, you’ll make a GET request to the /api/clients/{id}/ endpoint to retrieve details about a single client.

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

   curl -X GET http://localhost:8000/api/clients/550e8400-e29b-41d4-a716-446655440000/ \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

   The API returns a 200 OK and the details of the client:

   get_client_response.json

   {
     "id": "550e8400-e29b-41d4-a716-446655440000",
     "first_name": "John",
     "last_name": "Doe",
     "city": "Cleveland",
     "state": "OH",
     "zip_code": "44122",
     "email": "john.doe@example.com",
     "phone_number": "+12161231234",
     "created_at": "2026-05-21T10:00:00Z"
   }

2. Using the Python SDK:

   get_client.py

   from fstop import Fstop
   
   with Fstop(jwt_auth="YOUR_ACCESS_TOKEN") as f_client:
       client_data = f_client.clients.retrieve_client(id="550e8400-e29b-41d4-a716-446655440000")
   
       print(f"{client_data.first_name} {client_data.last_name}")
       print(f"Email: {client_data.email}")

You can use the returned client data in your application. For example, you could display the client’s contact information or use their ID to retrieve related projects and bookings.

What to do next

See GET /api/clients/{id}/ for a full list of request parameters and response schemas.