[{"data":1,"prerenderedAt":1931},["ShallowReactive",2],{"navigation":3,"\u002Fapi\u002Fguides\u002Ftime":547,"\u002Fapi\u002Fguides\u002Ftime-surround":1926},[4,28,62,92,117,146,253,292,325,349,385,421,459,488],{"title":5,"path":6,"stem":7,"children":8,"icon":27},"Getting Started","\u002Fgetting-started","1.getting-started\u002F1.index",[9,12,17,22],{"title":10,"path":6,"stem":7,"icon":11},"Introduction","i-lucide-house",{"title":13,"path":14,"stem":15,"icon":16},"Usage","\u002Fgetting-started\u002Fusage","1.getting-started\u002F3.usage","i-lucide-sliders",{"title":18,"path":19,"stem":20,"icon":21},"Signing in on the mobile app","\u002Fgetting-started\u002Fmobile-app-sign-in","1.getting-started\u002F4.mobile-app-sign-in","i-lucide-smartphone",{"title":23,"path":24,"stem":25,"icon":26},"Running without email","\u002Fgetting-started\u002Frunning-without-email","1.getting-started\u002F5.running-without-email","i-lucide-mail-x",false,{"title":29,"icon":27,"path":30,"stem":31,"children":32,"page":27},"Security & Privacy","\u002Fsecurity","10.security",[33,38,43,47,52,57],{"title":34,"path":35,"stem":36,"icon":37},"Security Overview","\u002Fsecurity\u002Foverview","10.security\u002F1.overview","i-lucide-shield-check",{"title":39,"path":40,"stem":41,"icon":42},"Authentication","\u002Fsecurity\u002Fauthentication","10.security\u002F2.authentication","i-lucide-log-in",{"title":44,"path":45,"stem":46,"icon":21},"Two-Factor & Devices","\u002Fsecurity\u002Ftwo-factor-and-devices","10.security\u002F3.two-factor-and-devices",{"title":48,"path":49,"stem":50,"icon":51},"Audit & Monitoring","\u002Fsecurity\u002Faudit-and-monitoring","10.security\u002F4.audit-and-monitoring","i-lucide-scroll-text",{"title":53,"path":54,"stem":55,"icon":56},"Account Deletion & Privacy","\u002Fsecurity\u002Faccount-deletion-and-privacy","10.security\u002F5.account-deletion-and-privacy","i-lucide-user-x",{"title":58,"path":59,"stem":60,"icon":61},"Roles & Permissions","\u002Fsecurity\u002Froles-and-permissions","10.security\u002F6.roles-and-permissions","i-lucide-key-round",{"title":63,"icon":27,"path":64,"stem":65,"children":66,"page":27},"Billing & Plans","\u002Fbilling","11.billing",[67,72,77,82,87],{"title":68,"path":69,"stem":70,"icon":71},"Plans","\u002Fbilling\u002Fplans","11.billing\u002F1.plans","i-lucide-credit-card",{"title":73,"path":74,"stem":75,"icon":76},"Limits & Usage","\u002Fbilling\u002Flimits-and-usage","11.billing\u002F2.limits-and-usage","i-lucide-gauge",{"title":78,"path":79,"stem":80,"icon":81},"Managing Your Subscription","\u002Fbilling\u002Fmanaging-your-subscription","11.billing\u002F3.managing-your-subscription","i-lucide-receipt",{"title":83,"path":84,"stem":85,"icon":86},"Add-ons","\u002Fbilling\u002Fadd-ons","11.billing\u002F4.add-ons","i-lucide-puzzle",{"title":88,"path":89,"stem":90,"icon":91},"Integrations","\u002Fbilling\u002Fintegrations","11.billing\u002F5.integrations","i-lucide-plug",{"title":93,"icon":27,"path":94,"stem":95,"children":96,"page":27},"Settings","\u002Fsettings","12.settings",[97,101,105,109,113],{"title":98,"path":99,"stem":100},"General","\u002Fsettings\u002Fgeneral","12.settings\u002F1.general",{"title":102,"path":103,"stem":104},"Leave Types","\u002Fsettings\u002Fleavetype","12.settings\u002F2.leaveType",{"title":106,"path":107,"stem":108},"Carry Forward","\u002Fsettings\u002Fcarryforward","12.settings\u002F3.carryForward",{"title":110,"path":111,"stem":112},"Department Management","\u002Fsettings\u002Fdepartments","12.settings\u002F4.departments",{"title":114,"path":115,"stem":116},"Public Holidays","\u002Fsettings\u002Fpublicholiday","12.settings\u002F5.publicholiday",{"title":118,"path":119,"stem":120,"children":121,"page":27},"Mcp","\u002Fmcp","13.mcp",[122,127,131,136,141],{"title":123,"path":124,"stem":125,"icon":126},"Overview","\u002Fmcp\u002Foverview","13.mcp\u002F1.overview","i-lucide-bot",{"title":128,"path":129,"stem":130,"icon":91},"Connecting","\u002Fmcp\u002Fconnecting","13.mcp\u002F2.connecting",{"title":132,"path":133,"stem":134,"icon":135},"Tools Reference","\u002Fmcp\u002Ftools","13.mcp\u002F3.tools","i-lucide-wrench",{"title":137,"path":138,"stem":139,"icon":140},"Security","\u002Fmcp\u002Fsecurity","13.mcp\u002F4.security","i-lucide-shield",{"title":142,"path":143,"stem":144,"icon":145},"Integrating Your Own MCP Client","\u002Fmcp\u002Fcustom-client","13.mcp\u002F5.custom-client","i-lucide-code",{"title":147,"icon":27,"path":148,"stem":149,"children":150,"page":27},"Public API","\u002Fapi","14.api",[151,156,160,164,169,174,179,183,208,238,243,248],{"title":152,"path":153,"stem":154,"icon":155},"API Overview","\u002Fapi\u002Foverview","14.api\u002F1.overview","i-lucide-code-xml",{"title":5,"path":157,"stem":158,"icon":159},"\u002Fapi\u002Fgetting-started","14.api\u002F2.getting-started","i-lucide-rocket",{"title":161,"path":162,"stem":163,"icon":61},"Authentication & Tokens","\u002Fapi\u002Fauthentication","14.api\u002F3.authentication",{"title":165,"path":166,"stem":167,"icon":168},"API Roles & Scopes","\u002Fapi\u002Froles-and-scopes","14.api\u002F4.roles-and-scopes","i-lucide-layers",{"title":170,"path":171,"stem":172,"icon":173},"Requests & Responses","\u002Fapi\u002Frequests-and-responses","14.api\u002F5.requests-and-responses","i-lucide-arrow-left-right",{"title":175,"path":176,"stem":177,"icon":178},"Errors","\u002Fapi\u002Ferrors","14.api\u002F6.errors","i-lucide-circle-alert",{"title":180,"path":181,"stem":182,"icon":76},"Rate Limits","\u002Fapi\u002Frate-limits","14.api\u002F7.rate-limits",{"title":184,"icon":185,"path":186,"stem":187,"children":188,"page":27},"Guides","i-lucide-book-marked","\u002Fapi\u002Fguides","14.api\u002F8.guides",[189,194,199,204],{"title":190,"path":191,"stem":192,"icon":193},"People","\u002Fapi\u002Fguides\u002Fpeople","14.api\u002F8.guides\u002F1.people","i-lucide-users",{"title":195,"path":196,"stem":197,"icon":198},"Leave","\u002Fapi\u002Fguides\u002Fleave","14.api\u002F8.guides\u002F2.leave","i-lucide-calendar-days",{"title":200,"path":201,"stem":202,"icon":203},"Time","\u002Fapi\u002Fguides\u002Ftime","14.api\u002F8.guides\u002F3.time","i-lucide-clock",{"title":205,"path":206,"stem":207,"icon":81},"Expenses & Documents","\u002Fapi\u002Fguides\u002Fexpenses-and-documents","14.api\u002F8.guides\u002F4.expenses-and-documents",{"title":209,"icon":210,"path":211,"stem":212,"children":213,"page":27},"Webhooks","i-lucide-webhook","\u002Fapi\u002Fwebhooks","14.api\u002F9.webhooks",[214,218,223,228,233],{"title":215,"path":216,"stem":217,"icon":210},"Webhooks Overview","\u002Fapi\u002Fwebhooks\u002Foverview","14.api\u002F9.webhooks\u002F1.overview",{"title":219,"path":220,"stem":221,"icon":222},"Events Reference","\u002Fapi\u002Fwebhooks\u002Fevents","14.api\u002F9.webhooks\u002F2.events","i-lucide-list",{"title":224,"path":225,"stem":226,"icon":227},"Verifying Signatures","\u002Fapi\u002Fwebhooks\u002Fverifying-signatures","14.api\u002F9.webhooks\u002F3.verifying-signatures","i-lucide-badge-check",{"title":229,"path":230,"stem":231,"icon":232},"Retries & Failures","\u002Fapi\u002Fwebhooks\u002Fretries-and-failures","14.api\u002F9.webhooks\u002F4.retries-and-failures","i-lucide-refresh-cw",{"title":234,"path":235,"stem":236,"icon":237},"Best Practices","\u002Fapi\u002Fwebhooks\u002Fbest-practices","14.api\u002F9.webhooks\u002F5.best-practices","i-lucide-list-checks",{"title":239,"path":240,"stem":241,"icon":242},"Postman & OpenAPI","\u002Fapi\u002Fpostman-and-openapi","14.api\u002F91.postman-and-openapi","i-lucide-file-json",{"title":244,"path":245,"stem":246,"icon":247},"Versioning & Changes","\u002Fapi\u002Fversioning","14.api\u002F92.versioning","i-lucide-git-branch",{"title":249,"path":250,"stem":251,"icon":252},"API Reference","\u002Fapi\u002Freference","14.api\u002F93.reference","i-lucide-book-open",{"title":254,"icon":27,"path":255,"stem":256,"children":257,"page":27},"Data Import & Migration","\u002Fdata-import","2.data-import",[258,262,267,272,277,282,287],{"title":123,"path":259,"stem":260,"icon":261},"\u002Fdata-import\u002Foverview","2.data-import\u002F1.overview","i-lucide-database",{"title":263,"path":264,"stem":265,"icon":266},"Importing a File","\u002Fdata-import\u002Fimporting-a-file","2.data-import\u002F2.importing-a-file","i-lucide-file-up",{"title":268,"path":269,"stem":270,"icon":271},"Supported Platforms","\u002Fdata-import\u002Fsupported-platforms","2.data-import\u002F3.supported-platforms","i-lucide-layout-grid",{"title":273,"path":274,"stem":275,"icon":276},"Direct Connections","\u002Fdata-import\u002Fdirect-connections","2.data-import\u002F4.direct-connections","i-lucide-plug-zap",{"title":278,"path":279,"stem":280,"icon":281},"Custom Templates","\u002Fdata-import\u002Fcustom-templates","2.data-import\u002F5.custom-templates","i-lucide-layout-template",{"title":283,"path":284,"stem":285,"icon":286},"Rollback & Import History","\u002Fdata-import\u002Frollback-and-history","2.data-import\u002F6.rollback-and-history","i-lucide-undo-2",{"title":288,"path":289,"stem":290,"icon":291},"Troubleshooting","\u002Fdata-import\u002Ftroubleshooting","2.data-import\u002F7.troubleshooting","i-lucide-life-buoy",{"title":293,"icon":27,"path":294,"stem":295,"children":296,"page":27},"Leave Management","\u002Fleave-management","3.leave-management",[297,302,307,312,316,321],{"title":298,"path":299,"stem":300,"icon":301},"Leave Management Overview","\u002Fleave-management\u002Foverview","3.leave-management\u002F1.overview","i-lucide-palmtree",{"title":303,"path":304,"stem":305,"icon":306},"Requesting Leave","\u002Fleave-management\u002Frequesting-leave","3.leave-management\u002F2.requesting-leave","i-lucide-calendar-plus",{"title":308,"path":309,"stem":310,"icon":311},"Leave Balances","\u002Fleave-management\u002Fleave-balances","3.leave-management\u002F3.leave-balances","i-lucide-wallet",{"title":313,"path":314,"stem":315,"icon":193},"Group Booking","\u002Fleave-management\u002Fgroup-booking","3.leave-management\u002F4.group-booking",{"title":317,"path":318,"stem":319,"icon":320},"Editing and Cancelling Leave","\u002Fleave-management\u002Fediting-and-cancelling","3.leave-management\u002F5.editing-and-cancelling","i-lucide-pencil",{"title":322,"path":323,"stem":324,"icon":291},"Leave Troubleshooting","\u002Fleave-management\u002Ftroubleshooting","3.leave-management\u002F6.troubleshooting",{"title":326,"icon":27,"path":327,"stem":328,"children":329,"page":27},"Approvals","\u002Fapprovals","4.approvals",[330,335,340,344],{"title":331,"path":332,"stem":333,"icon":334},"Approvals Overview","\u002Fapprovals\u002Foverview","4.approvals\u002F1.overview","i-lucide-check-check",{"title":336,"path":337,"stem":338,"icon":339},"Leave Approvals","\u002Fapprovals\u002Fleave-approvals","4.approvals\u002F2.leave-approvals","i-lucide-calendar-check",{"title":341,"path":342,"stem":343,"icon":81},"Expense Approvals","\u002Fapprovals\u002Fexpense-approvals","4.approvals\u002F3.expense-approvals",{"title":345,"path":346,"stem":347,"icon":348},"Time Approvals","\u002Fapprovals\u002Ftime-approvals","4.approvals\u002F4.time-approvals","i-lucide-clock-9",{"title":350,"icon":27,"path":351,"stem":352,"children":353,"page":27},"Time tracking & monitoring","\u002Ftime-tracking","5.Time Tracking",[354,359,364,369,373,377,381],{"title":355,"path":356,"stem":357,"icon":358},"Clocking In & Location","\u002Ftime-tracking\u002Fclock-in-and-location","5.Time Tracking\u002F5.clock-in-and-location","i-lucide-map-pin",{"title":360,"path":361,"stem":362,"icon":363},"Overtime & Pay-Period Lockdown","\u002Ftime-tracking\u002Fovertime-and-lockdown","5.Time Tracking\u002F6.overtime-and-lockdown","i-lucide-lock",{"title":365,"path":366,"stem":367,"icon":368},"Geofencing","\u002Ftime-tracking\u002Fgeofencing","5.Time Tracking\u002F7.geofencing","i-lucide-map",{"title":370,"path":371,"stem":372},"Time & Projects","\u002Ftime-tracking\u002Ftimeandprojects","5.Time Tracking\u002FTime&Projects",{"title":374,"path":375,"stem":376},"Time Tracking","\u002Ftime-tracking\u002Ftime-tracking","5.Time Tracking\u002FTime-tracking",{"title":378,"path":379,"stem":380},"Timeboard","\u002Ftime-tracking\u002Ftimeboard","5.Time Tracking\u002FTimeBoard",{"title":382,"path":383,"stem":384},"Timesheets","\u002Ftime-tracking\u002Ftimesheets","5.Time Tracking\u002FTimesheets",{"title":386,"icon":27,"path":387,"stem":388,"children":389,"page":27},"Expenses","\u002Fexpenses","6.expenses",[390,394,398,402,406,411,416],{"title":391,"path":392,"stem":393},"Expense Claims","\u002Fexpenses\u002Foverview","6.expenses\u002F1.overview",{"title":395,"path":396,"stem":397},"Add & Manage Purchases","\u002Fexpenses\u002Fpurchases","6.expenses\u002F2.purchases",{"title":399,"path":400,"stem":401},"Travel & Mileage Entry","\u002Fexpenses\u002Ftravelentries","6.expenses\u002F3.travelentries",{"title":403,"path":404,"stem":405,"icon":71},"Company Card Expenses","\u002Fexpenses\u002Fcompany-cards","6.expenses\u002F4.company-cards",{"title":407,"path":408,"stem":409,"icon":410},"Per Diems","\u002Fexpenses\u002Fper-diems","6.expenses\u002F5.per-diems","i-lucide-utensils",{"title":412,"path":413,"stem":414,"icon":415},"Receipt Scanning","\u002Fexpenses\u002Freceipt-scanning","6.expenses\u002F6.receipt-scanning","i-lucide-scan-line",{"title":417,"path":418,"stem":419,"icon":420},"Statuses & Submission","\u002Fexpenses\u002Fstatuses-and-submission","6.expenses\u002F7.statuses-and-submission","i-lucide-git-pull-request-arrow",{"title":422,"icon":27,"path":423,"stem":424,"children":425,"page":27},"Documents & E-Signatures","\u002Fdocuments","7.documents",[426,430,435,440,445,449,454],{"title":123,"path":427,"stem":428,"icon":429},"\u002Fdocuments\u002Foverview","7.documents\u002F1.overview","i-lucide-folder-open",{"title":431,"path":432,"stem":433,"icon":434},"Uploading Documents","\u002Fdocuments\u002Fuploading","7.documents\u002F2.uploading","i-lucide-upload",{"title":436,"path":437,"stem":438,"icon":439},"E-Signatures","\u002Fdocuments\u002Fe-signatures","7.documents\u002F3.e-signatures","i-lucide-pen-tool",{"title":441,"path":442,"stem":443,"icon":444},"Audit Trail & Certificate","\u002Fdocuments\u002Faudit-trail","7.documents\u002F4.audit-trail","i-lucide-file-check",{"title":446,"path":447,"stem":448,"icon":281},"Templates & Bulk Send","\u002Fdocuments\u002Ftemplates-and-bulk-send","7.documents\u002F5.templates-and-bulk-send",{"title":450,"path":451,"stem":452,"icon":453},"Onboarding","\u002Fdocuments\u002Fonboarding","7.documents\u002F6.onboarding","i-lucide-user-plus",{"title":455,"path":456,"stem":457,"icon":458},"Offboarding","\u002Fdocuments\u002Foffboarding","7.documents\u002F7.offboarding","i-lucide-user-minus",{"title":460,"icon":27,"path":461,"stem":462,"children":463,"page":27},"People & HR","\u002Fpeople","8.people",[464,468,473,478,483],{"title":465,"path":466,"stem":467,"icon":193},"Directory & Profiles","\u002Fpeople\u002Fdirectory-and-profiles","8.people\u002F1.directory-and-profiles",{"title":469,"path":470,"stem":471,"icon":472},"Managing Users","\u002Fpeople\u002Fmanaging-users","8.people\u002F2.managing-users","i-lucide-user-cog",{"title":474,"path":475,"stem":476,"icon":477},"HR Records","\u002Fpeople\u002Fhr-records","8.people\u002F3.hr-records","i-lucide-folder-archive",{"title":479,"path":480,"stem":481,"icon":482},"Performance","\u002Fpeople\u002Fperformance","8.people\u002F4.performance","i-lucide-target",{"title":484,"path":485,"stem":486,"icon":487},"Training","\u002Fpeople\u002Ftraining","8.people\u002F5.training","i-lucide-graduation-cap",{"title":489,"icon":27,"path":490,"stem":491,"children":492,"page":27},"Features","\u002Ffeatures","9.features",[493,497,501,505,510,515,519,523,527,531,535,539,543],{"title":494,"path":495,"stem":496,"icon":11},"Home","\u002Ffeatures\u002Fhome","9.features\u002F1.home",{"title":498,"path":499,"stem":500},"Email Configuration (SMTP)","\u002Ffeatures\u002Femail-configuration","9.features\u002F10.email-configuration",{"title":502,"path":503,"stem":504},"SMTP troubleshoot","\u002Ffeatures\u002Fsmtp-troubleshoot","9.features\u002F11.smtp-troubleshoot",{"title":506,"path":507,"stem":508,"icon":509},"Notifications","\u002Ffeatures\u002Fnotifications","9.features\u002F12.notifications","i-lucide-bell",{"title":511,"path":512,"stem":513,"icon":514},"Reports","\u002Ffeatures\u002Freports","9.features\u002F13.reports","i-lucide-bar-chart-3",{"title":516,"path":517,"stem":518},"Dashboard","\u002Ffeatures\u002Fdashboard","9.features\u002F2.dashboard",{"title":520,"path":521,"stem":522},"Calendar & Leave Overview","\u002Ffeatures\u002Fcalendar","9.features\u002F3.calendar",{"title":524,"path":525,"stem":526},"Calendar Integration","\u002Ffeatures\u002Fcalendar-integration","9.features\u002F4.calendar-integration",{"title":528,"path":529,"stem":530},"Schedules","\u002Ffeatures\u002Fschedules","9.features\u002F5.schedules",{"title":532,"path":533,"stem":534},"Project Management","\u002Ffeatures\u002Fprojects","9.features\u002F6.projects",{"title":536,"path":537,"stem":538},"Expense Settings","\u002Ffeatures\u002Fexpense-settings","9.features\u002F7.expense-settings",{"title":540,"path":541,"stem":542},"Auth0 SSO Integration","\u002Ffeatures\u002Fauth0-integration","9.features\u002F8.auth0-integration",{"title":544,"path":545,"stem":546},"Password & Authentication Policy","\u002Ffeatures\u002Fpolicies","9.features\u002F9.policies",{"id":548,"title":200,"body":549,"description":1919,"extension":1920,"links":1921,"meta":1922,"navigation":1923,"path":201,"seo":1924,"stem":202,"__hash__":1925},"docs\u002F14.api\u002F8.guides\u002F3.time.md",{"type":550,"value":551,"toc":1908},"minimark",[552,561,579,584,709,721,725,747,764,777,781,791,841,1192,1232,1282,1301,1312,1316,1424,1461,1467,1471,1527,1565,1575,1579,1634,1660,1669,1679,1683,1744,1775,1781,1785,1815,1818,1829,1835,1839,1904],[553,554,555,556,560],"p",{},"This guide covers time tracking in the API: time entries, timesheets, projects and schedules. Every parameter and field is in the ",[557,558,249],"a",{"href":559},"\u002Fapi\u002Freference#tag\u002Ftime-entries",".",[562,563,566],"callout",{"color":564,"icon":565},"blue","i-lucide-info",[553,567,568,569,573,574,578],{},"Every endpoint in this guide needs ",[570,571,572],"strong",{},"time tracking"," switched on for the organization. While it is off they answer ",[575,576,577],"code",{},"403 MODULE_DISABLED",", and no time events are sent by webhook.",[580,581,583],"h2",{"id":582},"scopes-for-this-area","Scopes for this area",[585,586,587,603],"table",{},[588,589,590],"thead",{},[591,592,593,597,600],"tr",{},[594,595,596],"th",{},"Task",[594,598,599],{},"Scope",[594,601,602],{},"Lowest owner role",[604,605,606,620,633,645,658,670,685,697],"tbody",{},[591,607,608,612,617],{},[609,610,611],"td",{},"Read time entries",[609,613,614],{},[575,615,616],{},"time_entries:read",[609,618,619],{},"Employee",[591,621,622,625,630],{},[609,623,624],{},"Read clock-in and clock-out locations",[609,626,627],{},[575,628,629],{},"time_entries.location:read",[609,631,632],{},"Administrator",[591,634,635,638,643],{},[609,636,637],{},"Create, edit and delete time entries",[609,639,640],{},[575,641,642],{},"time_entries:write",[609,644,619],{},[591,646,647,650,655],{},[609,648,649],{},"Approve and reject time entries",[609,651,652],{},[575,653,654],{},"time_entries:approve",[609,656,657],{},"Department Head",[591,659,660,663,668],{},[609,661,662],{},"Read timesheets",[609,664,665],{},[575,666,667],{},"timesheets:read",[609,669,619],{},[591,671,672,675,683],{},[609,673,674],{},"Read timesheet pay figures",[609,676,677,679,680],{},[575,678,667],{}," and ",[575,681,682],{},"users.employment:read",[609,684,632],{},[591,686,687,690,695],{},[609,688,689],{},"Read projects, tasks and clients",[609,691,692],{},[575,693,694],{},"projects:read",[609,696,619],{},[591,698,699,702,707],{},[609,700,701],{},"Read shifts",[609,703,704],{},[575,705,706],{},"schedules:read",[609,708,619],{},[553,710,711,712,715,716,720],{},"The ",[570,713,714],{},"Time and payroll export"," ",[557,717,719],{"href":718},"\u002Fapi\u002Froles-and-scopes#built-in-templates","template"," bundles the read scopes a payroll export needs.",[580,722,724],{"id":723},"whose-time-a-token-can-see","Whose time a token can see",[726,727,728,735,741],"ul",{},[729,730,731,732,734],"li",{},"An ",[570,733,619],{},"'s token sees their own entries and timesheets.",[729,736,737,738,740],{},"A ",[570,739,657],{},"'s token sees the people in the departments they head or manage.",[729,742,743,746],{},[570,744,745],{},"Administrators and Executives"," see the whole organization.",[553,748,749,750,753,754,679,757,760,761,763],{},"An entry or timesheet the owner cannot see answers ",[575,751,752],{},"404 NOT_FOUND",". Filters such as ",[575,755,756],{},"user_id",[575,758,759],{},"department_id"," narrow that view and never widen it; ",[575,762,759],{}," is for Administrator and Executive owners.",[553,765,766,767,770,771,774,775,560],{},"Money fields on a time entry (",[575,768,769],{},"hourly_rate",", ",[575,772,773],{},"billable_amount",") appear on the owner's own entries, and on everyone's for Department Heads and above. Location fields (coordinates, addresses, accuracy, whether the clock-in was outside the geofence) need ",[575,776,629],{},[580,778,780],{"id":779},"export-hours-for-a-pay-period","Export hours for a pay period",[553,782,783,786,787,790],{},[575,784,785],{},"GET \u002Ftime-entries"," reads a window of calendar days in the organization's timezone. The window defaults to the last 30 days and can be at most ",[570,788,789],{},"120 days",". Results are newest first.",[792,793,798],"pre",{"className":794,"code":795,"language":796,"meta":797,"style":797},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl \"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Ftime-entries?start_date=2026-09-28&end_date=2026-10-11&approval_status=APPROVED&limit=100\" \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\"\n","bash","",[575,799,800,824],{"__ignoreMap":797},[801,802,805,809,813,817,820],"span",{"class":803,"line":804},"line",1,[801,806,808],{"class":807},"sBMFI","curl",[801,810,812],{"class":811},"sMK4o"," \"",[801,814,816],{"class":815},"sfazB","https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Ftime-entries?start_date=2026-09-28&end_date=2026-10-11&approval_status=APPROVED&limit=100",[801,818,819],{"class":811},"\"",[801,821,823],{"class":822},"sTEyZ"," \\\n",[801,825,827,830,832,835,838],{"class":803,"line":826},2,[801,828,829],{"class":815},"  -H",[801,831,812],{"class":811},[801,833,834],{"class":815},"Authorization: Bearer ",[801,836,837],{"class":822},"$BOOKYOURPTO_TOKEN",[801,839,840],{"class":811},"\"\n",[792,842,846],{"className":843,"code":844,"language":845,"meta":797,"style":797},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"data\": [\n    {\n      \"id\": \"cmte00000000000000000001\",\n      \"user_id\": \"cmusr0000000000000000012\",\n      \"clock_in\": \"2026-10-08T16:00:00.000Z\",\n      \"clock_out\": \"2026-10-09T00:30:00.000Z\",\n      \"break_minutes\": 30,\n      \"duration_minutes\": 480,\n      \"project_id\": \"cmprj0000000000000000003\",\n      \"task_id\": \"cmtsk0000000000000000007\",\n      \"is_billable\": true,\n      \"approval_status\": \"APPROVED\",\n      \"source\": \"API\",\n      \"...\": \"more fields\"\n    }\n  ],\n  \"meta\": { \"request_id\": \"...\", \"has_more\": false, \"next_cursor\": null }\n}\n","json",[575,847,848,853,870,876,899,919,940,961,979,996,1017,1038,1053,1074,1095,1114,1120,1126,1186],{"__ignoreMap":797},[801,849,850],{"class":803,"line":804},[801,851,852],{"class":811},"{\n",[801,854,855,858,862,864,867],{"class":803,"line":826},[801,856,857],{"class":811},"  \"",[801,859,861],{"class":860},"spNyl","data",[801,863,819],{"class":811},[801,865,866],{"class":811},":",[801,868,869],{"class":811}," [\n",[801,871,873],{"class":803,"line":872},3,[801,874,875],{"class":811},"    {\n",[801,877,879,882,885,887,889,891,894,896],{"class":803,"line":878},4,[801,880,881],{"class":811},"      \"",[801,883,884],{"class":807},"id",[801,886,819],{"class":811},[801,888,866],{"class":811},[801,890,812],{"class":811},[801,892,893],{"class":815},"cmte00000000000000000001",[801,895,819],{"class":811},[801,897,898],{"class":811},",\n",[801,900,902,904,906,908,910,912,915,917],{"class":803,"line":901},5,[801,903,881],{"class":811},[801,905,756],{"class":807},[801,907,819],{"class":811},[801,909,866],{"class":811},[801,911,812],{"class":811},[801,913,914],{"class":815},"cmusr0000000000000000012",[801,916,819],{"class":811},[801,918,898],{"class":811},[801,920,922,924,927,929,931,933,936,938],{"class":803,"line":921},6,[801,923,881],{"class":811},[801,925,926],{"class":807},"clock_in",[801,928,819],{"class":811},[801,930,866],{"class":811},[801,932,812],{"class":811},[801,934,935],{"class":815},"2026-10-08T16:00:00.000Z",[801,937,819],{"class":811},[801,939,898],{"class":811},[801,941,943,945,948,950,952,954,957,959],{"class":803,"line":942},7,[801,944,881],{"class":811},[801,946,947],{"class":807},"clock_out",[801,949,819],{"class":811},[801,951,866],{"class":811},[801,953,812],{"class":811},[801,955,956],{"class":815},"2026-10-09T00:30:00.000Z",[801,958,819],{"class":811},[801,960,898],{"class":811},[801,962,964,966,969,971,973,977],{"class":803,"line":963},8,[801,965,881],{"class":811},[801,967,968],{"class":807},"break_minutes",[801,970,819],{"class":811},[801,972,866],{"class":811},[801,974,976],{"class":975},"sbssI"," 30",[801,978,898],{"class":811},[801,980,982,984,987,989,991,994],{"class":803,"line":981},9,[801,983,881],{"class":811},[801,985,986],{"class":807},"duration_minutes",[801,988,819],{"class":811},[801,990,866],{"class":811},[801,992,993],{"class":975}," 480",[801,995,898],{"class":811},[801,997,999,1001,1004,1006,1008,1010,1013,1015],{"class":803,"line":998},10,[801,1000,881],{"class":811},[801,1002,1003],{"class":807},"project_id",[801,1005,819],{"class":811},[801,1007,866],{"class":811},[801,1009,812],{"class":811},[801,1011,1012],{"class":815},"cmprj0000000000000000003",[801,1014,819],{"class":811},[801,1016,898],{"class":811},[801,1018,1020,1022,1025,1027,1029,1031,1034,1036],{"class":803,"line":1019},11,[801,1021,881],{"class":811},[801,1023,1024],{"class":807},"task_id",[801,1026,819],{"class":811},[801,1028,866],{"class":811},[801,1030,812],{"class":811},[801,1032,1033],{"class":815},"cmtsk0000000000000000007",[801,1035,819],{"class":811},[801,1037,898],{"class":811},[801,1039,1041,1043,1046,1048,1050],{"class":803,"line":1040},12,[801,1042,881],{"class":811},[801,1044,1045],{"class":807},"is_billable",[801,1047,819],{"class":811},[801,1049,866],{"class":811},[801,1051,1052],{"class":811}," true,\n",[801,1054,1056,1058,1061,1063,1065,1067,1070,1072],{"class":803,"line":1055},13,[801,1057,881],{"class":811},[801,1059,1060],{"class":807},"approval_status",[801,1062,819],{"class":811},[801,1064,866],{"class":811},[801,1066,812],{"class":811},[801,1068,1069],{"class":815},"APPROVED",[801,1071,819],{"class":811},[801,1073,898],{"class":811},[801,1075,1077,1079,1082,1084,1086,1088,1091,1093],{"class":803,"line":1076},14,[801,1078,881],{"class":811},[801,1080,1081],{"class":807},"source",[801,1083,819],{"class":811},[801,1085,866],{"class":811},[801,1087,812],{"class":811},[801,1089,1090],{"class":815},"API",[801,1092,819],{"class":811},[801,1094,898],{"class":811},[801,1096,1098,1100,1103,1105,1107,1109,1112],{"class":803,"line":1097},15,[801,1099,881],{"class":811},[801,1101,1102],{"class":807},"...",[801,1104,819],{"class":811},[801,1106,866],{"class":811},[801,1108,812],{"class":811},[801,1110,1111],{"class":815},"more fields",[801,1113,840],{"class":811},[801,1115,1117],{"class":803,"line":1116},16,[801,1118,1119],{"class":811},"    }\n",[801,1121,1123],{"class":803,"line":1122},17,[801,1124,1125],{"class":811},"  ],\n",[801,1127,1129,1131,1134,1136,1138,1141,1143,1146,1148,1150,1152,1154,1156,1159,1161,1164,1166,1168,1171,1173,1176,1178,1180,1183],{"class":803,"line":1128},18,[801,1130,857],{"class":811},[801,1132,1133],{"class":860},"meta",[801,1135,819],{"class":811},[801,1137,866],{"class":811},[801,1139,1140],{"class":811}," {",[801,1142,812],{"class":811},[801,1144,1145],{"class":807},"request_id",[801,1147,819],{"class":811},[801,1149,866],{"class":811},[801,1151,812],{"class":811},[801,1153,1102],{"class":815},[801,1155,819],{"class":811},[801,1157,1158],{"class":811},",",[801,1160,812],{"class":811},[801,1162,1163],{"class":807},"has_more",[801,1165,819],{"class":811},[801,1167,866],{"class":811},[801,1169,1170],{"class":811}," false,",[801,1172,812],{"class":811},[801,1174,1175],{"class":807},"next_cursor",[801,1177,819],{"class":811},[801,1179,866],{"class":811},[801,1181,1182],{"class":811}," null",[801,1184,1185],{"class":811}," }\n",[801,1187,1189],{"class":803,"line":1188},19,[801,1190,1191],{"class":811},"}\n",[726,1193,1194,1204,1217],{},[729,1195,1196,679,1198,1200,1201,1203],{},[575,1197,926],{},[575,1199,947],{}," are instants in UTC. ",[575,1202,986],{}," already has the break taken off.",[729,1205,1206,1207,770,1209,770,1211,770,1213,679,1215,560],{},"Filter with ",[575,1208,756],{},[575,1210,759],{},[575,1212,1003],{},[575,1214,1060],{},[575,1216,1045],{},[729,1218,1219,1220,1223,1224,1227,1228,1231],{},"A window longer than 120 days, or an ",[575,1221,1222],{},"end_date"," before ",[575,1225,1226],{},"start_date",", answers ",[575,1229,1230],{},"422 VALIDATION_FAILED",". For a longer period, request it in windows of up to 120 days.",[553,1233,1234,1235,1238,1239,1242,1243,770,1246,770,1249,770,1251,770,1254,1257,1258,1261,1262,770,1265,770,1268,679,1270,1272,1273,1275,1276,1278,1279,560],{},"If your organization runs period timesheets, ",[575,1236,1237],{},"GET \u002Ftimesheets"," is usually the better source for payroll: one row per person per period with regular, overtime, holiday and paid-leave minutes, and the period's ",[575,1240,1241],{},"status"," (",[575,1244,1245],{},"OPEN",[575,1247,1248],{},"SUBMITTED",[575,1250,1069],{},[575,1252,1253],{},"FINALIZED",[575,1255,1256],{},"SIGNED"," or ",[575,1259,1260],{},"REJECTED","). Filter with ",[575,1263,1264],{},"period_start",[575,1266,1267],{},"period_end",[575,1269,756],{},[575,1271,1241],{},". An ",[575,1274,1245],{}," timesheet carries its totals as last computed, so wait for ",[575,1277,1253],{}," before paying from it, or subscribe to ",[575,1280,1281],{},"timesheet.finalized",[553,1283,1284,1285,770,1288,770,1291,770,1294,1297,1298,1300],{},"Pay figures (",[575,1286,1287],{},"regular_pay",[575,1289,1290],{},"overtime_pay",[575,1292,1293],{},"total_pay",[575,1295,1296],{},"currency",") appear only when the token holds ",[575,1299,682],{}," and its owner is an Administrator or Executive. They are never sent by webhook.",[553,1302,1303,1304,770,1308,560],{},"Reference: ",[557,1305,1307],{"href":1306},"\u002Fapi\u002Freference#tag\u002Ftime-entries\u002FGET\u002Ftime-entries","List time entries",[557,1309,1311],{"href":1310},"\u002Fapi\u002Freference#tag\u002Ftimesheets\u002FGET\u002Ftimesheets","List timesheets",[580,1313,1315],{"id":1314},"record-hours","Record hours",[792,1317,1319],{"className":794,"code":1318,"language":796,"meta":797,"style":797},"curl -X POST https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Ftime-entries \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -H \"Idempotency-Key: 9b3e6f10-2c4a-4d8b-8e7f-1a5c3d9e2b64\" \\\n  -d '{\n    \"clock_in\": \"2026-10-08T09:00:00-07:00\",\n    \"clock_out\": \"2026-10-08T17:30:00-07:00\",\n    \"break_minutes\": 30,\n    \"project_id\": \"cmprj0000000000000000003\",\n    \"task_id\": \"cmtsk0000000000000000007\",\n    \"description\": \"Cycle count, aisles 4 to 9\"\n  }'\n",[575,1320,1321,1336,1350,1363,1376,1386,1391,1396,1401,1406,1411,1416],{"__ignoreMap":797},[801,1322,1323,1325,1328,1331,1334],{"class":803,"line":804},[801,1324,808],{"class":807},[801,1326,1327],{"class":815}," -X",[801,1329,1330],{"class":815}," POST",[801,1332,1333],{"class":815}," https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Ftime-entries",[801,1335,823],{"class":822},[801,1337,1338,1340,1342,1344,1346,1348],{"class":803,"line":826},[801,1339,829],{"class":815},[801,1341,812],{"class":811},[801,1343,834],{"class":815},[801,1345,837],{"class":822},[801,1347,819],{"class":811},[801,1349,823],{"class":822},[801,1351,1352,1354,1356,1359,1361],{"class":803,"line":872},[801,1353,829],{"class":815},[801,1355,812],{"class":811},[801,1357,1358],{"class":815},"Content-Type: application\u002Fjson",[801,1360,819],{"class":811},[801,1362,823],{"class":822},[801,1364,1365,1367,1369,1372,1374],{"class":803,"line":878},[801,1366,829],{"class":815},[801,1368,812],{"class":811},[801,1370,1371],{"class":815},"Idempotency-Key: 9b3e6f10-2c4a-4d8b-8e7f-1a5c3d9e2b64",[801,1373,819],{"class":811},[801,1375,823],{"class":822},[801,1377,1378,1381,1384],{"class":803,"line":901},[801,1379,1380],{"class":815},"  -d",[801,1382,1383],{"class":811}," '",[801,1385,852],{"class":815},[801,1387,1388],{"class":803,"line":921},[801,1389,1390],{"class":815},"    \"clock_in\": \"2026-10-08T09:00:00-07:00\",\n",[801,1392,1393],{"class":803,"line":942},[801,1394,1395],{"class":815},"    \"clock_out\": \"2026-10-08T17:30:00-07:00\",\n",[801,1397,1398],{"class":803,"line":963},[801,1399,1400],{"class":815},"    \"break_minutes\": 30,\n",[801,1402,1403],{"class":803,"line":981},[801,1404,1405],{"class":815},"    \"project_id\": \"cmprj0000000000000000003\",\n",[801,1407,1408],{"class":803,"line":998},[801,1409,1410],{"class":815},"    \"task_id\": \"cmtsk0000000000000000007\",\n",[801,1412,1413],{"class":803,"line":1019},[801,1414,1415],{"class":815},"    \"description\": \"Cycle count, aisles 4 to 9\"\n",[801,1417,1418,1421],{"class":803,"line":1040},[801,1419,1420],{"class":815},"  }",[801,1422,1423],{"class":811},"'\n",[726,1425,1426,1440,1443,1448,1451],{},[729,1427,1428,679,1430,1432,1433,1436,1437,560],{},[575,1429,926],{},[575,1431,947],{}," are ISO 8601 date-times ",[570,1434,1435],{},"with a timezone offset",". Entries made this way have ",[575,1438,1439],{},"source: \"API\"",[729,1441,1442],{},"Your organization must allow manual time entry; Administrators and Executives are exempt.",[729,1444,1445,1446,560],{},"Only Administrator and Executive owners can create entries for someone else, with ",[575,1447,756],{},[729,1449,1450],{},"Entries in a locked pay period are refused. Your organization's rounding rules apply.",[729,1452,1453,1454,1457,1458,560],{},"An Administrator's or Executive's entry is approved at once. Otherwise the entry is ",[575,1455,1456],{},"PENDING"," when your organization requires approval, and a completed pending entry raises ",[575,1459,1460],{},"time_entry.submitted",[553,1462,1303,1463,560],{},[557,1464,1466],{"href":1465},"\u002Fapi\u002Freference#tag\u002Ftime-entries\u002FPOST\u002Ftime-entries","Create a time entry",[580,1468,1470],{"id":1469},"correct-or-delete-an-entry","Correct or delete an entry",[792,1472,1474],{"className":794,"code":1473,"language":796,"meta":797,"style":797},"curl -X PATCH https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Ftime-entries\u002Fcmte00000000000000000001 \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{ \"clock_out\": \"2026-10-08T18:00:00-07:00\", \"description\": \"Cycle count, aisles 4 to 11\" }'\n",[575,1475,1476,1490,1504,1516],{"__ignoreMap":797},[801,1477,1478,1480,1482,1485,1488],{"class":803,"line":804},[801,1479,808],{"class":807},[801,1481,1327],{"class":815},[801,1483,1484],{"class":815}," PATCH",[801,1486,1487],{"class":815}," https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Ftime-entries\u002Fcmte00000000000000000001",[801,1489,823],{"class":822},[801,1491,1492,1494,1496,1498,1500,1502],{"class":803,"line":826},[801,1493,829],{"class":815},[801,1495,812],{"class":811},[801,1497,834],{"class":815},[801,1499,837],{"class":822},[801,1501,819],{"class":811},[801,1503,823],{"class":822},[801,1505,1506,1508,1510,1512,1514],{"class":803,"line":872},[801,1507,829],{"class":815},[801,1509,812],{"class":811},[801,1511,1358],{"class":815},[801,1513,819],{"class":811},[801,1515,823],{"class":822},[801,1517,1518,1520,1522,1525],{"class":803,"line":878},[801,1519,1380],{"class":815},[801,1521,1383],{"class":811},[801,1523,1524],{"class":815},"{ \"clock_out\": \"2026-10-08T18:00:00-07:00\", \"description\": \"Cycle count, aisles 4 to 11\" }",[801,1526,1423],{"class":811},[726,1528,1529,1532,1535,1548,1554,1559],{},[729,1530,1531],{},"Only the entry's owner, or an Administrator or Executive, can edit or delete it.",[729,1533,1534],{},"Clock times can be edited only when your organization allows it; Administrators and Executives are exempt.",[729,1536,1537,1538,1257,1540,1542,1543,679,1545,1547],{},"When anyone other than an Administrator or Executive changes the hours, project, task, billing or rate of an ",[575,1539,1069],{},[575,1541,1260],{}," entry, it goes back to ",[575,1544,1456],{},[575,1546,1460],{}," is raised again.",[729,1549,1550,1551,560],{},"Hours, rate and billing inside a finalized or signed timesheet cannot change: ",[575,1552,1553],{},"409 CONFLICT",[729,1555,1556,1558],{},[575,1557,769],{}," can be set only by Administrator and Executive owners.",[729,1560,1561,1564],{},[575,1562,1563],{},"DELETE \u002Ftime-entries\u002F{id}"," marks the entry deleted and removes it from every list. It returns the entry as it now stands.",[553,1566,1303,1567,770,1571,560],{},[557,1568,1570],{"href":1569},"\u002Fapi\u002Freference#tag\u002Ftime-entries\u002FPATCH\u002Ftime-entries\u002F%7Bid%7D","Update",[557,1572,1574],{"href":1573},"\u002Fapi\u002Freference#tag\u002Ftime-entries\u002FDELETE\u002Ftime-entries\u002F%7Bid%7D","Delete",[580,1576,1578],{"id":1577},"approve-or-reject-time","Approve or reject time",[792,1580,1582],{"className":794,"code":1581,"language":796,"meta":797,"style":797},"curl -X POST https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Ftime-entries\u002Fcmte00000000000000000001\u002Freject \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{ \"reason\": \"Break not recorded; please add it and resubmit.\" }'\n",[575,1583,1584,1597,1611,1623],{"__ignoreMap":797},[801,1585,1586,1588,1590,1592,1595],{"class":803,"line":804},[801,1587,808],{"class":807},[801,1589,1327],{"class":815},[801,1591,1330],{"class":815},[801,1593,1594],{"class":815}," https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Ftime-entries\u002Fcmte00000000000000000001\u002Freject",[801,1596,823],{"class":822},[801,1598,1599,1601,1603,1605,1607,1609],{"class":803,"line":826},[801,1600,829],{"class":815},[801,1602,812],{"class":811},[801,1604,834],{"class":815},[801,1606,837],{"class":822},[801,1608,819],{"class":811},[801,1610,823],{"class":822},[801,1612,1613,1615,1617,1619,1621],{"class":803,"line":872},[801,1614,829],{"class":815},[801,1616,812],{"class":811},[801,1618,1358],{"class":815},[801,1620,819],{"class":811},[801,1622,823],{"class":822},[801,1624,1625,1627,1629,1632],{"class":803,"line":878},[801,1626,1380],{"class":815},[801,1628,1383],{"class":811},[801,1630,1631],{"class":815},"{ \"reason\": \"Break not recorded; please add it and resubmit.\" }",[801,1633,1423],{"class":811},[726,1635,1636,1642,1648,1651],{},[729,1637,1638,1639,1641],{},"Needs ",[575,1640,654],{},", and an owner who is an active Department Head, Administrator or Executive.",[729,1643,1644,1645,560],{},"Nobody approves or rejects their own entries: ",[575,1646,1647],{},"403 FORBIDDEN",[729,1649,1650],{},"A Department Head decides only for people in their department scope.",[729,1652,1653,1654,679,1657,560],{},"A rejection reason is added to the entry's notes. The events are ",[575,1655,1656],{},"time_entry.approved",[575,1658,1659],{},"time_entry.rejected",[553,1661,1662,1663,1666,1667,560],{},"To build an approval queue, list ",[575,1664,1665],{},"GET \u002Ftime-entries?approval_status=PENDING"," with the approver's token, or subscribe to ",[575,1668,1460],{},[553,1670,1303,1671,770,1675,560],{},[557,1672,1674],{"href":1673},"\u002Fapi\u002Freference#tag\u002Ftime-entries\u002FPOST\u002Ftime-entries\u002F%7Bid%7D\u002Fapprove","Approve",[557,1676,1678],{"href":1677},"\u002Fapi\u002Freference#tag\u002Ftime-entries\u002FPOST\u002Ftime-entries\u002F%7Bid%7D\u002Freject","Reject",[580,1680,1682],{"id":1681},"projects-tasks-and-clients","Projects, tasks and clients",[792,1684,1686],{"className":794,"code":1685,"language":796,"meta":797,"style":797},"curl \"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fprojects?status=ACTIVE\" \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\"\n\ncurl \"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fprojects\u002Fcmprj0000000000000000003\u002Ftasks\" \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\"\n",[575,1687,1688,1701,1713,1719,1732],{"__ignoreMap":797},[801,1689,1690,1692,1694,1697,1699],{"class":803,"line":804},[801,1691,808],{"class":807},[801,1693,812],{"class":811},[801,1695,1696],{"class":815},"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fprojects?status=ACTIVE",[801,1698,819],{"class":811},[801,1700,823],{"class":822},[801,1702,1703,1705,1707,1709,1711],{"class":803,"line":826},[801,1704,829],{"class":815},[801,1706,812],{"class":811},[801,1708,834],{"class":815},[801,1710,837],{"class":822},[801,1712,840],{"class":811},[801,1714,1715],{"class":803,"line":872},[801,1716,1718],{"emptyLinePlaceholder":1717},true,"\n",[801,1720,1721,1723,1725,1728,1730],{"class":803,"line":878},[801,1722,808],{"class":807},[801,1724,812],{"class":811},[801,1726,1727],{"class":815},"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fprojects\u002Fcmprj0000000000000000003\u002Ftasks",[801,1729,819],{"class":811},[801,1731,823],{"class":822},[801,1733,1734,1736,1738,1740,1742],{"class":803,"line":901},[801,1735,829],{"class":815},[801,1737,812],{"class":811},[801,1739,834],{"class":815},[801,1741,837],{"class":822},[801,1743,840],{"class":811},[726,1745,1746,1749,1755,1764],{},[729,1747,1748],{},"Administrators and Executives see every project; everyone else sees their department's projects plus organization-wide ones.",[729,1750,1751,1752,1754],{},"A project's ",[575,1753,769],{}," and money budget appear only for Department Head, Administrator and Executive owners.",[729,1756,1757,1760,1761,560],{},[575,1758,1759],{},"GET \u002Fprojects\u002F{id}\u002Ftasks"," returns every task of the project as a flat list; subtasks carry ",[575,1762,1763],{},"parent_task_id",[729,1765,1766,1769,1770,1772,1773,560],{},[575,1767,1768],{},"GET \u002Fclients"," is for Department Heads and above. An Employee's token gets ",[575,1771,1647],{},", even with ",[575,1774,694],{},[553,1776,1303,1777,560],{},[557,1778,1780],{"href":1779},"\u002Fapi\u002Freference#tag\u002Fprojects","Projects",[580,1782,1784],{"id":1783},"shift-schedules","Shift schedules",[792,1786,1788],{"className":794,"code":1787,"language":796,"meta":797,"style":797},"curl \"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fshifts?start_date=2026-10-12&end_date=2026-10-25\" \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\"\n",[575,1789,1790,1803],{"__ignoreMap":797},[801,1791,1792,1794,1796,1799,1801],{"class":803,"line":804},[801,1793,808],{"class":807},[801,1795,812],{"class":811},[801,1797,1798],{"class":815},"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fshifts?start_date=2026-10-12&end_date=2026-10-25",[801,1800,819],{"class":811},[801,1802,823],{"class":822},[801,1804,1805,1807,1809,1811,1813],{"class":803,"line":826},[801,1806,829],{"class":815},[801,1808,812],{"class":811},[801,1810,834],{"class":815},[801,1812,837],{"class":822},[801,1814,840],{"class":811},[553,1816,1817],{},"The window defaults to the next 7 days, starting today, and can be at most 120 days. Results are earliest first. Which shifts a token sees follows your organization's schedule visibility settings:",[726,1819,1820,1823,1826],{},[729,1821,1822],{},"Administrators and Executives see every shift; Department Heads see their department scope.",[729,1824,1825],{},"Employees see their own shifts, or their department's or everyone's when your organization allows it, plus open shifts in their department.",[729,1827,1828],{},"Employees do not see weeks that have not been published, unless your organization uses default schedules.",[553,1830,1303,1831,560],{},[557,1832,1834],{"href":1833},"\u002Fapi\u002Freference#tag\u002Fschedules\u002FGET\u002Fshifts","List shifts",[580,1836,1838],{"id":1837},"gotchas","Gotchas",[726,1840,1841,1851,1865,1885,1898],{},[729,1842,1843,1846,1847,1850],{},[570,1844,1845],{},"Clocking in and out is not available through the API."," Location and geofence checks belong to the device. Use ",[575,1848,1849],{},"POST \u002Ftime-entries"," to record hours after the fact.",[729,1852,1853,1856,1857,1860,1861,1864],{},[570,1854,1855],{},"Windows are calendar days in the organization's timezone,"," not UTC. Read ",[575,1858,1859],{},"timezone"," from ",[575,1862,1863],{},"GET \u002Forganization"," when you build the dates.",[729,1866,1867,1870,1871,1257,1873,1875,1876,1257,1879,1882,1883,560],{},[570,1868,1869],{},"Send offsets with times."," A ",[575,1872,926],{},[575,1874,947],{}," without a timezone offset, such as ",[575,1877,1878],{},"-07:00",[575,1880,1881],{},"Z",", is refused with ",[575,1884,1230],{},[729,1886,1887,1890,1891,1893,1894,1897],{},[570,1888,1889],{},"An edit can send an entry back for approval."," Expect ",[575,1892,1060],{}," to change after a ",[575,1895,1896],{},"PATCH"," by a non-administrator.",[729,1899,1900,1903],{},[570,1901,1902],{},"Every page of a time-entry list is recorded as an export"," in the audit log.",[1905,1906,1907],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}",{"title":797,"searchDepth":804,"depth":826,"links":1909},[1910,1911,1912,1913,1914,1915,1916,1917,1918],{"id":582,"depth":826,"text":583},{"id":723,"depth":826,"text":724},{"id":779,"depth":826,"text":780},{"id":1314,"depth":826,"text":1315},{"id":1469,"depth":826,"text":1470},{"id":1577,"depth":826,"text":1578},{"id":1681,"depth":826,"text":1682},{"id":1783,"depth":826,"text":1784},{"id":1837,"depth":826,"text":1838},"Export time entries and timesheets for payroll, record and correct hours, approve time, and read projects, tasks, clients and shift schedules through the API.","md",null,{},{"icon":203},{"title":200,"description":1919},"8hkU2MenjwtNYyCl-XtPXc14V8ZZ_889zUDjd1l2uiQ",[1927,1929],{"title":195,"path":196,"stem":197,"description":1928,"icon":198,"children":-1},"Read leave types, requests, balances, public holidays and locked dates, book and cancel leave, and approve or reject requests through the API, with the visibility rules that apply.",{"title":205,"path":206,"stem":207,"description":1930,"icon":81,"children":-1},"Export expense reports to accounting, approve or reject them, and read document metadata, signers and files through the API, with the visibility rules that apply.",1791906546151]