cancel
Showing results for 
Search instead for 
Did you mean: 

Any interest in knowing how to work with API's?

ashokr
Community Ambassador

I'm a command line junkie :-). I have some scripts that can perform sales analysis and employee timecard tasks on the command line.

  • Works well on macOS and Linux. 
  • For Windows, I think the best is to install WSL for a Linux environment.
  • I have a cron job set up that can simply email me the timing for each employee. Every Sunday since our pay dates are Sunday - Saturday. And flexible to do different things for different employees if you don't have the same schedule. 

If there is interest, I can post the scripts here or give a pointer to a git repo. 

Ashoks-Air:toast-menu-generator araj$ ./sales.py -
--all --file --last-year --this-year -h
--compare --help --range --today
--date --last-month --this-month --yesterday
--debug --last-week --this-week -d

(venv) Ashoks-Air:toast-menu-generator araj$ ./emptime.py -h
usage: emptime.py [-h] [-t] [-s START] [-e END] [-d]

Toast API Time Logs Manager

============================================================
TIME LOG SUMMARY (2025-08-17 to 2025-08-23)
============================================================
Emp1:
Regular Hours: 40.00
Overtime Hours: 14.80
Total Hours: 54.80
Entries: 11

Emp2
Regular Hours: 27.55
Overtime Hours: 0.00
Total Hours: 27.55
Entries: 6


Detailed time log entries saved to time_logs_detailed_2025-08-17_to_2025-08-23.json
Total detailed entries: 17

optional arguments:
-h, --help show this help message and exit
-t, --time-logs Get time logs for employees (uses previous week:
Sunday to Saturday)
-s START, --start START
Start date (YYYY-MM-DD) - must be used with -e
-e END, --end END End date (YYYY-MM-DD) - must be used with -s
-d, --debug Enable debug output showing detailed API responses

Cheers, Ashok

 

- Ashok Raj
Toast Community Ambassador
6 REPLIES 6

josh212
Main Course I

So you have two options… one you can have data exports enabled which allows you to connect to an aws data warehouse sftp container for your location each day … the other is you can request ready only permission for some of the scopes including configuration api, labor api, menus api, menus v2 api, payments api, orders api,, restaurant api, and inventory api. You can learn about more of This through doc.toasttab.com , you will also be able to download the most recent postman collection and create sandbox credentials which will allow you to receive a bearer token authorizing you for a read only scope 

Josh
Community Ambassador

www
Salad I

Hi @ashokr 

Thanks for sharing your knowledge of Toast API access with us 😁

I believe we have Standard API access already. We are interested in seeing if we can pull Loyalty data  (since normal web search is so slow).

But based on this chart, it seems to suggest that the Loyalty API is only available to Toast Partners and Custom integrations?

https://doc.toasttab.com/doc/devguide/apiOverview.html

 

Do you know if that's the case?