Data in guestbook does not match Orders api data with guest attached.

Kyle Worrall

April 19, 2026 17:31

I have noticed that the Toast Guestbook Web UI is able to detect more of a customers orders than just order with the customer info attached to them. I assume this is done with payment fingerprinting. Would having access to the Analytics API, specifically the guest reports endpoint, provide all of the information needed to have the same data that Toast does inside Guestbook?

0

• 

  John Duggan

  April 22, 2026 13:55

  Hi Kyle,

  Thanks for reaching out!

  The Analytics API does expose a cardFingerprint field in the guest reports endpoint, but it is unlikely to fully replicate what you’re seeing in Guestbook.

  From what’s documented in the Toast support article on the Guestbook report, it builds guest profiles based on identity information such as email and phone number collected across different guest touchpoints. In contrast, cardFingerprint is limited to associating transactions at the payment level and isn’t sufficient on its own to construct a complete guest profile.

  That said, I’m not able to speak in detail to Guestbook’s internal matching logic beyond what’s publicly documented, as that falls outside of the APIs our team supports. For more specifics, I’d recommend reaching out to Toast Support. More info here on how to contact Toast Support

  One important limitation to note: cardFingerprint data in the Analytics API is only available for payments processed starting in August 2024.

  A couple of resources that may help:

  • Analtyics API Guest reporting data reference: 
  • Guestbook support article

  Best,
  
  John

  0

Please sign in to leave a comment.