How to retrieve historical/deleted clients by internal client ID via Admin API?

API General
1

Hello,

We are reconciling historical client records with our SimplyBook.me booking history using the Admin API.

Our historical booking data contains 2,770 distinct client IDs.

Using:

getClientList("", null)

we currently receive 1,408 client records, including the fields id, name, email, phone, and selector.

1,229 of the client IDs found in our historical bookings are present in the current getClientList response, but 1,541 historical client IDs are not returned anymore.

We are trying to determine whether those missing IDs correspond to deleted, archived, merged, or otherwise historical client records.

Is there an Admin API method or another provider-supported way to retrieve historical client records by their internal SimplyBook client ID?

Specifically, we would like to know:

  1. Does getClientList exclude deleted, archived, or merged clients?
  2. Is there an API method to retrieve a client directly by internal client ID, including historical/inactive records?
  3. Is deleted/archived client data retained and accessible through any API or export?
  4. Does SimplyBook retain merge/supersession history for client records?
  5. If this information is not available through the API, is there a supported historical export that includes the internal client ID?

This is for a read-only data reconciliation process. We are not trying to modify any SimplyBook data.

Thank you.

2

hi, there are could be a few potential reasons. First please check your client report and see how many clients are there? Are all clients have bookings or some don’t?

3

Hi, thank you.

I checked the Client Report as well.

It contains 1,408 client records, which matches the number returned by getClientList("", null).

Our historical booking dataset, however, contains 2,770 distinct SimplyBook client IDs.

Out of those 2,770 IDs:

  • 1,229 are currently present in getClientList
  • 1,541 historical client IDs are not returned by getClientList

The Client Report export does not include the internal SimplyBook client ID, so we cannot directly determine from that report which current clients correspond to which historical booking client IDs.

We do know that our historical booking data includes 2,770 client IDs with at least one booking each, because those IDs come directly from booking records.

So the question is specifically about the 1,541 historical client IDs that still exist in the booking history but are no longer returned by the current client list/API.

Could those IDs correspond to deleted, archived, merged, or otherwise inactive client records?

And is there any API method or backend export that can retrieve those historical client records by their internal SimplyBook client ID?

4

As API consistent with the report it means it works correctly and nothing needs to be fixed