[{"data":1,"prerenderedAt":1994},["ShallowReactive",2],{"navigation":3,"\u002Fapi\u002Fguides\u002Fexpenses-and-documents":547,"\u002Fapi\u002Fguides\u002Fexpenses-and-documents-surround":1989},[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":205,"body":549,"description":1982,"extension":1983,"links":1984,"meta":1985,"navigation":1986,"path":206,"seo":1987,"stem":207,"__hash__":1988},"docs\u002F14.api\u002F8.guides\u002F4.expenses-and-documents.md",{"type":550,"value":551,"toc":1968},"minimark",[552,561,566,641,645,662,667,689,699,703,753,803,806,836,1498,1519,1534,1545,1549,1610,1666,1676,1680,1684,1687,1707,1712,1716,1746,1791,1810,1815,1819,1885,1924,1930,1934,1964],[553,554,555,556,560],"p",{},"This guide covers expense reports and documents. Every parameter and field is in the ",[557,558,249],"a",{"href":559},"\u002Fapi\u002Freference#tag\u002Fexpense-reports",".",[562,563,565],"h2",{"id":564},"scopes-for-this-area","Scopes for this area",[567,568,569,585],"table",{},[570,571,572],"thead",{},[573,574,575,579,582],"tr",{},[576,577,578],"th",{},"Task",[576,580,581],{},"Scope",[576,583,584],{},"Lowest owner role",[586,587,588,603,616,628],"tbody",{},[573,589,590,594,600],{},[591,592,593],"td",{},"Read expense reports",[591,595,596],{},[597,598,599],"code",{},"expenses:read",[591,601,602],{},"Employee",[573,604,605,608,613],{},[591,606,607],{},"Approve and reject expense reports",[591,609,610],{},[597,611,612],{},"expenses:approve",[591,614,615],{},"Department Head",[573,617,618,621,626],{},[591,619,620],{},"Read document metadata and signers",[591,622,623],{},[597,624,625],{},"documents:read",[591,627,602],{},[573,629,630,633,638],{},[591,631,632],{},"Download document files",[591,634,635],{},[597,636,637],{},"documents.content:read",[591,639,640],{},"Administrator",[562,642,644],{"id":643},"expense-reports","Expense reports",[646,647,650],"callout",{"color":648,"icon":649},"blue","i-lucide-info",[553,651,652,653,657,658,661],{},"The expense endpoints need ",[654,655,656],"strong",{},"expenses"," switched on for the organization. While it is off they answer ",[597,659,660],{},"403 MODULE_DISABLED",", and no expense events are sent by webhook.",[663,664,666],"h3",{"id":665},"whose-reports-a-token-can-see","Whose reports a token can see",[668,669,670,677,683],"ul",{},[671,672,673,674,676],"li",{},"An ",[654,675,602],{},"'s token lists the reports they submitted.",[671,678,679,680,682],{},"A ",[654,681,615],{},"'s token lists reports submitted by people in the departments they head or manage.",[671,684,685,688],{},[654,686,687],{},"Administrators and Executives"," list every report in the organization.",[553,690,691,694,695,698],{},[597,692,693],{},"GET \u002Fexpense-reports\u002F{id}"," also opens a report the owner is the assigned approver of. A report the owner cannot see answers ",[597,696,697],{},"404 NOT_FOUND",". Filters narrow the view and never widen it.",[663,700,702],{"id":701},"export-approved-reports","Export approved reports",[704,705,710],"pre",{"className":706,"code":707,"language":708,"meta":709,"style":709},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl \"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fexpense-reports?status=APPROVED&from=2026-09-01&to=2026-09-30&limit=100\" \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\"\n","bash","",[597,711,712,736],{"__ignoreMap":709},[713,714,717,721,725,729,732],"span",{"class":715,"line":716},"line",1,[713,718,720],{"class":719},"sBMFI","curl",[713,722,724],{"class":723},"sMK4o"," \"",[713,726,728],{"class":727},"sfazB","https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fexpense-reports?status=APPROVED&from=2026-09-01&to=2026-09-30&limit=100",[713,730,731],{"class":723},"\"",[713,733,735],{"class":734},"sTEyZ"," \\\n",[713,737,739,742,744,747,750],{"class":715,"line":738},2,[713,740,741],{"class":727},"  -H",[713,743,724],{"class":723},[713,745,746],{"class":727},"Authorization: Bearer ",[713,748,749],{"class":734},"$BOOKYOURPTO_TOKEN",[713,751,752],{"class":723},"\"\n",[553,754,755,756,759,760,759,763,759,766,759,769,759,772,775,776,759,779,782,783,786,787,790,791,794,795,798,799,802],{},"The list returns each report's header: number, title, submitter, approver, dates, status and totals (",[597,757,758],{},"total_expenses",", ",[597,761,762],{},"total_per_diems",[597,764,765],{},"total_mileage",[597,767,768],{},"total_tax",[597,770,771],{},"grand_total",[597,773,774],{},"currency","), with counts of line items, per diems, mileage entries and receipts. Results are newest first. Filter with ",[597,777,778],{},"status",[597,780,781],{},"report_type"," (",[597,784,785],{},"REIMBURSEMENT"," or ",[597,788,789],{},"COMPANY_CARD","), ",[597,792,793],{},"user_id",", and ",[597,796,797],{},"from"," \u002F ",[597,800,801],{},"to",", which match the trip's departure and return days.",[553,804,805],{},"For the lines, read each report:",[704,807,809],{"className":706,"code":808,"language":708,"meta":709,"style":709},"curl \"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fexpense-reports\u002Fcmexp0000000000000000042\" \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\"\n",[597,810,811,824],{"__ignoreMap":709},[713,812,813,815,817,820,822],{"class":715,"line":716},[713,814,720],{"class":719},[713,816,724],{"class":723},[713,818,819],{"class":727},"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fexpense-reports\u002Fcmexp0000000000000000042",[713,821,731],{"class":723},[713,823,735],{"class":734},[713,825,826,828,830,832,834],{"class":715,"line":738},[713,827,741],{"class":727},[713,829,724],{"class":723},[713,831,746],{"class":727},[713,833,749],{"class":734},[713,835,752],{"class":723},[704,837,841],{"className":838,"code":839,"language":840,"meta":709,"style":709},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"data\": {\n    \"id\": \"cmexp0000000000000000042\",\n    \"report_number\": \"EXP-2026-0042\",\n    \"status\": \"APPROVED\",\n    \"currency\": \"CAD\",\n    \"grand_total\": 605.58,\n    \"line_items\": [\n      { \"id\": \"cmeli0000000000000000001\", \"date\": \"2026-09-14\", \"vendor\": \"Harbourfront Suites\", \"expense_type\": \"ACCOMMODATION\", \"amount_before_tax\": 412, \"gst\": 20.6, \"total\": 432.6, \"receipt_id\": \"cmerc0000000000000000001\", \"...\": \"more fields\" }\n    ],\n    \"per_diems\": [ { \"date\": \"2026-09-15\", \"per_diem_type\": \"FULL_DAY\", \"rate\": 112.5, \"total\": 112.5, \"...\": \"more fields\" } ],\n    \"mileage\": [ { \"date\": \"2026-09-16\", \"distance\": 84, \"unit\": \"KILOMETERS\", \"rate_per_unit\": 0.72, \"total\": 60.48, \"...\": \"more fields\" } ],\n    \"receipts\": [ { \"id\": \"cmerc0000000000000000001\", \"file_name\": \"harbourfront-folio.pdf\", \"mime_type\": \"application\u002Fpdf\", \"size_bytes\": 184220 } ],\n    \"...\": \"the header fields\"\n  },\n  \"meta\": { \"request_id\": \"...\" }\n}\n","json",[597,842,843,848,865,888,909,929,949,966,981,1138,1144,1243,1353,1437,1455,1461,1492],{"__ignoreMap":709},[713,844,845],{"class":715,"line":716},[713,846,847],{"class":723},"{\n",[713,849,850,853,857,859,862],{"class":715,"line":738},[713,851,852],{"class":723},"  \"",[713,854,856],{"class":855},"spNyl","data",[713,858,731],{"class":723},[713,860,861],{"class":723},":",[713,863,864],{"class":723}," {\n",[713,866,868,871,874,876,878,880,883,885],{"class":715,"line":867},3,[713,869,870],{"class":723},"    \"",[713,872,873],{"class":719},"id",[713,875,731],{"class":723},[713,877,861],{"class":723},[713,879,724],{"class":723},[713,881,882],{"class":727},"cmexp0000000000000000042",[713,884,731],{"class":723},[713,886,887],{"class":723},",\n",[713,889,891,893,896,898,900,902,905,907],{"class":715,"line":890},4,[713,892,870],{"class":723},[713,894,895],{"class":719},"report_number",[713,897,731],{"class":723},[713,899,861],{"class":723},[713,901,724],{"class":723},[713,903,904],{"class":727},"EXP-2026-0042",[713,906,731],{"class":723},[713,908,887],{"class":723},[713,910,912,914,916,918,920,922,925,927],{"class":715,"line":911},5,[713,913,870],{"class":723},[713,915,778],{"class":719},[713,917,731],{"class":723},[713,919,861],{"class":723},[713,921,724],{"class":723},[713,923,924],{"class":727},"APPROVED",[713,926,731],{"class":723},[713,928,887],{"class":723},[713,930,932,934,936,938,940,942,945,947],{"class":715,"line":931},6,[713,933,870],{"class":723},[713,935,774],{"class":719},[713,937,731],{"class":723},[713,939,861],{"class":723},[713,941,724],{"class":723},[713,943,944],{"class":727},"CAD",[713,946,731],{"class":723},[713,948,887],{"class":723},[713,950,952,954,956,958,960,964],{"class":715,"line":951},7,[713,953,870],{"class":723},[713,955,771],{"class":719},[713,957,731],{"class":723},[713,959,861],{"class":723},[713,961,963],{"class":962},"sbssI"," 605.58",[713,965,887],{"class":723},[713,967,969,971,974,976,978],{"class":715,"line":968},8,[713,970,870],{"class":723},[713,972,973],{"class":719},"line_items",[713,975,731],{"class":723},[713,977,861],{"class":723},[713,979,980],{"class":723}," [\n",[713,982,984,987,989,991,993,995,997,1000,1002,1005,1007,1010,1012,1014,1016,1019,1021,1023,1025,1028,1030,1032,1034,1037,1039,1041,1043,1046,1048,1050,1052,1055,1057,1059,1061,1064,1066,1068,1071,1073,1075,1078,1080,1082,1085,1087,1089,1092,1094,1096,1099,1101,1103,1106,1108,1110,1112,1115,1117,1119,1121,1124,1126,1128,1130,1133,1135],{"class":715,"line":983},9,[713,985,986],{"class":723},"      {",[713,988,724],{"class":723},[713,990,873],{"class":962},[713,992,731],{"class":723},[713,994,861],{"class":723},[713,996,724],{"class":723},[713,998,999],{"class":727},"cmeli0000000000000000001",[713,1001,731],{"class":723},[713,1003,1004],{"class":723},",",[713,1006,724],{"class":723},[713,1008,1009],{"class":962},"date",[713,1011,731],{"class":723},[713,1013,861],{"class":723},[713,1015,724],{"class":723},[713,1017,1018],{"class":727},"2026-09-14",[713,1020,731],{"class":723},[713,1022,1004],{"class":723},[713,1024,724],{"class":723},[713,1026,1027],{"class":962},"vendor",[713,1029,731],{"class":723},[713,1031,861],{"class":723},[713,1033,724],{"class":723},[713,1035,1036],{"class":727},"Harbourfront Suites",[713,1038,731],{"class":723},[713,1040,1004],{"class":723},[713,1042,724],{"class":723},[713,1044,1045],{"class":962},"expense_type",[713,1047,731],{"class":723},[713,1049,861],{"class":723},[713,1051,724],{"class":723},[713,1053,1054],{"class":727},"ACCOMMODATION",[713,1056,731],{"class":723},[713,1058,1004],{"class":723},[713,1060,724],{"class":723},[713,1062,1063],{"class":962},"amount_before_tax",[713,1065,731],{"class":723},[713,1067,861],{"class":723},[713,1069,1070],{"class":962}," 412",[713,1072,1004],{"class":723},[713,1074,724],{"class":723},[713,1076,1077],{"class":962},"gst",[713,1079,731],{"class":723},[713,1081,861],{"class":723},[713,1083,1084],{"class":962}," 20.6",[713,1086,1004],{"class":723},[713,1088,724],{"class":723},[713,1090,1091],{"class":962},"total",[713,1093,731],{"class":723},[713,1095,861],{"class":723},[713,1097,1098],{"class":962}," 432.6",[713,1100,1004],{"class":723},[713,1102,724],{"class":723},[713,1104,1105],{"class":962},"receipt_id",[713,1107,731],{"class":723},[713,1109,861],{"class":723},[713,1111,724],{"class":723},[713,1113,1114],{"class":727},"cmerc0000000000000000001",[713,1116,731],{"class":723},[713,1118,1004],{"class":723},[713,1120,724],{"class":723},[713,1122,1123],{"class":962},"...",[713,1125,731],{"class":723},[713,1127,861],{"class":723},[713,1129,724],{"class":723},[713,1131,1132],{"class":727},"more fields",[713,1134,731],{"class":723},[713,1136,1137],{"class":723}," }\n",[713,1139,1141],{"class":715,"line":1140},10,[713,1142,1143],{"class":723},"    ],\n",[713,1145,1147,1149,1152,1154,1156,1159,1162,1164,1166,1168,1170,1172,1175,1177,1179,1181,1184,1186,1188,1190,1193,1195,1197,1199,1202,1204,1206,1209,1211,1213,1215,1217,1219,1221,1223,1225,1227,1229,1231,1233,1235,1237,1240],{"class":715,"line":1146},11,[713,1148,870],{"class":723},[713,1150,1151],{"class":719},"per_diems",[713,1153,731],{"class":723},[713,1155,861],{"class":723},[713,1157,1158],{"class":723}," [",[713,1160,1161],{"class":723}," {",[713,1163,724],{"class":723},[713,1165,1009],{"class":962},[713,1167,731],{"class":723},[713,1169,861],{"class":723},[713,1171,724],{"class":723},[713,1173,1174],{"class":727},"2026-09-15",[713,1176,731],{"class":723},[713,1178,1004],{"class":723},[713,1180,724],{"class":723},[713,1182,1183],{"class":962},"per_diem_type",[713,1185,731],{"class":723},[713,1187,861],{"class":723},[713,1189,724],{"class":723},[713,1191,1192],{"class":727},"FULL_DAY",[713,1194,731],{"class":723},[713,1196,1004],{"class":723},[713,1198,724],{"class":723},[713,1200,1201],{"class":962},"rate",[713,1203,731],{"class":723},[713,1205,861],{"class":723},[713,1207,1208],{"class":962}," 112.5",[713,1210,1004],{"class":723},[713,1212,724],{"class":723},[713,1214,1091],{"class":962},[713,1216,731],{"class":723},[713,1218,861],{"class":723},[713,1220,1208],{"class":962},[713,1222,1004],{"class":723},[713,1224,724],{"class":723},[713,1226,1123],{"class":962},[713,1228,731],{"class":723},[713,1230,861],{"class":723},[713,1232,724],{"class":723},[713,1234,1132],{"class":727},[713,1236,731],{"class":723},[713,1238,1239],{"class":723}," }",[713,1241,1242],{"class":723}," ],\n",[713,1244,1246,1248,1251,1253,1255,1257,1259,1261,1263,1265,1267,1269,1272,1274,1276,1278,1281,1283,1285,1288,1290,1292,1295,1297,1299,1301,1304,1306,1308,1310,1313,1315,1317,1320,1322,1324,1326,1328,1330,1333,1335,1337,1339,1341,1343,1345,1347,1349,1351],{"class":715,"line":1245},12,[713,1247,870],{"class":723},[713,1249,1250],{"class":719},"mileage",[713,1252,731],{"class":723},[713,1254,861],{"class":723},[713,1256,1158],{"class":723},[713,1258,1161],{"class":723},[713,1260,724],{"class":723},[713,1262,1009],{"class":962},[713,1264,731],{"class":723},[713,1266,861],{"class":723},[713,1268,724],{"class":723},[713,1270,1271],{"class":727},"2026-09-16",[713,1273,731],{"class":723},[713,1275,1004],{"class":723},[713,1277,724],{"class":723},[713,1279,1280],{"class":962},"distance",[713,1282,731],{"class":723},[713,1284,861],{"class":723},[713,1286,1287],{"class":962}," 84",[713,1289,1004],{"class":723},[713,1291,724],{"class":723},[713,1293,1294],{"class":962},"unit",[713,1296,731],{"class":723},[713,1298,861],{"class":723},[713,1300,724],{"class":723},[713,1302,1303],{"class":727},"KILOMETERS",[713,1305,731],{"class":723},[713,1307,1004],{"class":723},[713,1309,724],{"class":723},[713,1311,1312],{"class":962},"rate_per_unit",[713,1314,731],{"class":723},[713,1316,861],{"class":723},[713,1318,1319],{"class":962}," 0.72",[713,1321,1004],{"class":723},[713,1323,724],{"class":723},[713,1325,1091],{"class":962},[713,1327,731],{"class":723},[713,1329,861],{"class":723},[713,1331,1332],{"class":962}," 60.48",[713,1334,1004],{"class":723},[713,1336,724],{"class":723},[713,1338,1123],{"class":962},[713,1340,731],{"class":723},[713,1342,861],{"class":723},[713,1344,724],{"class":723},[713,1346,1132],{"class":727},[713,1348,731],{"class":723},[713,1350,1239],{"class":723},[713,1352,1242],{"class":723},[713,1354,1356,1358,1361,1363,1365,1367,1369,1371,1373,1375,1377,1379,1381,1383,1385,1387,1390,1392,1394,1396,1399,1401,1403,1405,1408,1410,1412,1414,1417,1419,1421,1423,1426,1428,1430,1433,1435],{"class":715,"line":1355},13,[713,1357,870],{"class":723},[713,1359,1360],{"class":719},"receipts",[713,1362,731],{"class":723},[713,1364,861],{"class":723},[713,1366,1158],{"class":723},[713,1368,1161],{"class":723},[713,1370,724],{"class":723},[713,1372,873],{"class":962},[713,1374,731],{"class":723},[713,1376,861],{"class":723},[713,1378,724],{"class":723},[713,1380,1114],{"class":727},[713,1382,731],{"class":723},[713,1384,1004],{"class":723},[713,1386,724],{"class":723},[713,1388,1389],{"class":962},"file_name",[713,1391,731],{"class":723},[713,1393,861],{"class":723},[713,1395,724],{"class":723},[713,1397,1398],{"class":727},"harbourfront-folio.pdf",[713,1400,731],{"class":723},[713,1402,1004],{"class":723},[713,1404,724],{"class":723},[713,1406,1407],{"class":962},"mime_type",[713,1409,731],{"class":723},[713,1411,861],{"class":723},[713,1413,724],{"class":723},[713,1415,1416],{"class":727},"application\u002Fpdf",[713,1418,731],{"class":723},[713,1420,1004],{"class":723},[713,1422,724],{"class":723},[713,1424,1425],{"class":962},"size_bytes",[713,1427,731],{"class":723},[713,1429,861],{"class":723},[713,1431,1432],{"class":962}," 184220",[713,1434,1239],{"class":723},[713,1436,1242],{"class":723},[713,1438,1440,1442,1444,1446,1448,1450,1453],{"class":715,"line":1439},14,[713,1441,870],{"class":723},[713,1443,1123],{"class":719},[713,1445,731],{"class":723},[713,1447,861],{"class":723},[713,1449,724],{"class":723},[713,1451,1452],{"class":727},"the header fields",[713,1454,752],{"class":723},[713,1456,1458],{"class":715,"line":1457},15,[713,1459,1460],{"class":723},"  },\n",[713,1462,1464,1466,1469,1471,1473,1475,1477,1480,1482,1484,1486,1488,1490],{"class":715,"line":1463},16,[713,1465,852],{"class":723},[713,1467,1468],{"class":855},"meta",[713,1470,731],{"class":723},[713,1472,861],{"class":723},[713,1474,1161],{"class":723},[713,1476,724],{"class":723},[713,1478,1479],{"class":719},"request_id",[713,1481,731],{"class":723},[713,1483,861],{"class":723},[713,1485,724],{"class":723},[713,1487,1123],{"class":727},[713,1489,731],{"class":723},[713,1491,1137],{"class":723},[713,1493,1495],{"class":715,"line":1494},17,[713,1496,1497],{"class":723},"}\n",[668,1499,1500,1507,1514],{},[671,1501,1502,1503,1506],{},"Amounts are numbers in the currency named next to them; each line also has ",[597,1504,1505],{},"total_in_base_currency"," for the organization's currency.",[671,1508,1509,1510,1513],{},"Line dates are calendar days (",[597,1511,1512],{},"YYYY-MM-DD",").",[671,1515,1516,1518],{},[597,1517,1360],{}," lists each receipt's metadata. Receipt images and files are not available through the API.",[553,1520,1521,1522,1525,1526,1529,1530,1513],{},"To pick up reports as they are approved or paid, rather than polling, subscribe to ",[597,1523,1524],{},"expense_report.approved"," and ",[597,1527,1528],{},"expense_report.paid"," (see ",[557,1531,1533],{"href":1532},"\u002Fapi\u002Fwebhooks\u002Fevents#expenses","Events",[553,1535,1536,1537,759,1541,560],{},"Reference: ",[557,1538,1540],{"href":1539},"\u002Fapi\u002Freference#tag\u002Fexpense-reports\u002FGET\u002Fexpense-reports","List expense reports",[557,1542,1544],{"href":1543},"\u002Fapi\u002Freference#tag\u002Fexpense-reports\u002FGET\u002Fexpense-reports\u002F%7Bid%7D","Get an expense report",[663,1546,1548],{"id":1547},"approve-or-reject-a-report","Approve or reject a report",[704,1550,1552],{"className":706,"code":1551,"language":708,"meta":709,"style":709},"curl -X POST https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fexpense-reports\u002Fcmexp0000000000000000042\u002Freject \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{ \"reason\": \"Hotel folio is missing the second night.\" }'\n",[597,1553,1554,1569,1583,1596],{"__ignoreMap":709},[713,1555,1556,1558,1561,1564,1567],{"class":715,"line":716},[713,1557,720],{"class":719},[713,1559,1560],{"class":727}," -X",[713,1562,1563],{"class":727}," POST",[713,1565,1566],{"class":727}," https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fexpense-reports\u002Fcmexp0000000000000000042\u002Freject",[713,1568,735],{"class":734},[713,1570,1571,1573,1575,1577,1579,1581],{"class":715,"line":738},[713,1572,741],{"class":727},[713,1574,724],{"class":723},[713,1576,746],{"class":727},[713,1578,749],{"class":734},[713,1580,731],{"class":723},[713,1582,735],{"class":734},[713,1584,1585,1587,1589,1592,1594],{"class":715,"line":867},[713,1586,741],{"class":727},[713,1588,724],{"class":723},[713,1590,1591],{"class":727},"Content-Type: application\u002Fjson",[713,1593,731],{"class":723},[713,1595,735],{"class":734},[713,1597,1598,1601,1604,1607],{"class":715,"line":890},[713,1599,1600],{"class":727},"  -d",[713,1602,1603],{"class":723}," '",[713,1605,1606],{"class":727},"{ \"reason\": \"Hotel folio is missing the second night.\" }",[713,1608,1609],{"class":723},"'\n",[668,1611,1612,1630,1643,1649,1655],{},[671,1613,1614,1617,1618,1621,1622,1625,1626,1629],{},[597,1615,1616],{},"\u002Fapprove"," takes optional ",[597,1619,1620],{},"notes","; ",[597,1623,1624],{},"\u002Freject"," requires a ",[597,1627,1628],{},"reason",". Both are shown to the submitter, who is notified.",[671,1631,1632,1633,786,1636,1639,1640,560],{},"Only a report awaiting a decision (",[597,1634,1635],{},"SUBMITTED",[597,1637,1638],{},"PENDING_APPROVAL",") can be decided. Any other state answers ",[597,1641,1642],{},"409 CONFLICT",[671,1644,1645,1646,560],{},"Administrators and Executives decide any report; a Department Head only reports from their department scope. A decision the owner may not make answers ",[597,1647,1648],{},"403 FORBIDDEN",[671,1650,1651,1654],{},[654,1652,1653],{},"Nobody decides their own report through the API",", including Administrators and Executives, who can in the app. A token is automation acting for its owner, and approving the owner's own spending automatically would defeat the separation of duties the approval exists for.",[671,1656,1657,1658,1525,1660,1663,1664,560],{},"The events are ",[597,1659,1524],{},[597,1661,1662],{},"expense_report.rejected",". Marking a report paid is done in the app, and raises ",[597,1665,1528],{},[553,1667,1536,1668,759,1672,560],{},[557,1669,1671],{"href":1670},"\u002Fapi\u002Freference#tag\u002Fexpense-reports\u002FPOST\u002Fexpense-reports\u002F%7Bid%7D\u002Fapprove","Approve",[557,1673,1675],{"href":1674},"\u002Fapi\u002Freference#tag\u002Fexpense-reports\u002FPOST\u002Fexpense-reports\u002F%7Bid%7D\u002Freject","Reject",[562,1677,1679],{"id":1678},"documents","Documents",[663,1681,1683],{"id":1682},"whose-documents-a-token-can-see","Whose documents a token can see",[553,1685,1686],{},"The token sees what its owner's document list shows in the app:",[668,1688,1689,1694,1699,1704],{},[671,1690,1691,1693],{},[654,1692,687],{}," see every document in the organization.",[671,1695,679,1696,1698],{},[654,1697,615],{}," sees their own documents and documents assigned to them for signature, plus documents they sent to people in their department scope.",[671,1700,673,1701,1703],{},[654,1702,602],{}," sees their own documents and documents assigned to them for signature.",[671,1705,1706],{},"In sequential signing, a signer whose turn has not come yet does not see the document.",[553,1708,1709,1710,560],{},"A document the owner cannot see answers ",[597,1711,697],{},[663,1713,1715],{"id":1714},"list-documents-and-their-signing-status","List documents and their signing status",[704,1717,1719],{"className":706,"code":1718,"language":708,"meta":709,"style":709},"curl \"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fdocuments?signature_status=PENDING\" \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\"\n",[597,1720,1721,1734],{"__ignoreMap":709},[713,1722,1723,1725,1727,1730,1732],{"class":715,"line":716},[713,1724,720],{"class":719},[713,1726,724],{"class":723},[713,1728,1729],{"class":727},"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fdocuments?signature_status=PENDING",[713,1731,731],{"class":723},[713,1733,735],{"class":734},[713,1735,1736,1738,1740,1742,1744],{"class":715,"line":738},[713,1737,741],{"class":727},[713,1739,724],{"class":723},[713,1741,746],{"class":727},[713,1743,749],{"class":734},[713,1745,752],{"class":723},[668,1747,1748,1775,1781],{},[671,1749,1750,1751,782,1754,759,1757,759,1760,759,1763,759,1766,790,1769,1525,1772,1774],{},"Filter with ",[597,1752,1753],{},"signature_status",[597,1755,1756],{},"NOT_REQUIRED",[597,1758,1759],{},"PENDING",[597,1761,1762],{},"SIGNED",[597,1764,1765],{},"DECLINED",[597,1767,1768],{},"EXPIRED",[597,1770,1771],{},"category",[597,1773,793],{}," (documents in that person's folder: owned by them or assigned to them to sign). Results are newest first.",[671,1776,1777,1778,560],{},"Per-person copies of onboarding documents are left out unless you add ",[597,1779,1780],{},"include_copies=true",[671,1782,1783,1786,1787,1790],{},[597,1784,1785],{},"GET \u002Fdocuments\u002F{id}"," adds ",[597,1788,1789],{},"signers",": each signer's status, signing order, due date and when they viewed, signed or declined.",[553,1792,1793,1794,1525,1797,1800,1801,1803,1804,1806,1807,1809],{},"Subscribe to ",[597,1795,1796],{},"document.signed",[597,1798,1799],{},"document.declined"," to follow signing without polling. ",[597,1802,1796],{}," is sent each time a signer signs; the document's ",[597,1805,1753],{}," becomes ",[597,1808,1762],{}," when the last signer has signed.",[553,1811,1536,1812,560],{},[557,1813,1679],{"href":1814},"\u002Fapi\u002Freference#tag\u002Fdocuments",[663,1816,1818],{"id":1817},"download-a-file","Download a file",[704,1820,1822],{"className":706,"code":1821,"language":708,"meta":709,"style":709},"curl \"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fdocuments\u002Fcmdoc0000000000000000007\u002Fcontent\" \\\n  -H \"Authorization: Bearer $BOOKYOURPTO_TOKEN\" \\\n  | jq -r '.data.content_base64' | base64 --decode > employment-agreement.pdf\n",[597,1823,1824,1837,1851],{"__ignoreMap":709},[713,1825,1826,1828,1830,1833,1835],{"class":715,"line":716},[713,1827,720],{"class":719},[713,1829,724],{"class":723},[713,1831,1832],{"class":727},"https:\u002F\u002Fapp.bookyourpto.com\u002Fapi\u002Fv1\u002Fdocuments\u002Fcmdoc0000000000000000007\u002Fcontent",[713,1834,731],{"class":723},[713,1836,735],{"class":734},[713,1838,1839,1841,1843,1845,1847,1849],{"class":715,"line":738},[713,1840,741],{"class":727},[713,1842,724],{"class":723},[713,1844,746],{"class":727},[713,1846,749],{"class":734},[713,1848,731],{"class":723},[713,1850,735],{"class":734},[713,1852,1853,1856,1859,1862,1864,1867,1870,1873,1876,1879,1882],{"class":715,"line":867},[713,1854,1855],{"class":723},"  |",[713,1857,1858],{"class":719}," jq",[713,1860,1861],{"class":727}," -r",[713,1863,1603],{"class":723},[713,1865,1866],{"class":727},".data.content_base64",[713,1868,1869],{"class":723},"'",[713,1871,1872],{"class":723}," |",[713,1874,1875],{"class":719}," base64",[713,1877,1878],{"class":727}," --decode",[713,1880,1881],{"class":723}," >",[713,1883,1884],{"class":727}," employment-agreement.pdf\n",[668,1886,1887,1893,1911,1921],{},[671,1888,1889,1890,1892],{},"Needs ",[597,1891,637],{},", which only Administrator and Executive owners can hold, and the document must be visible to the owner.",[671,1894,1895,1896,759,1898,1525,1900,1902,1903,1906,1907,1910],{},"The file comes back base64 encoded in the JSON envelope, with ",[597,1897,1389],{},[597,1899,1407],{},[597,1901,1425],{},". Files up to ",[654,1904,1905],{},"10 MB"," can be downloaded; larger files answer ",[597,1908,1909],{},"422 VALIDATION_FAILED"," and must be downloaded in the app.",[671,1912,1913,1914,1917,1918,560],{},"Each download counts as ",[654,1915,1916],{},"10 requests"," against the ",[557,1919,1920],{"href":181},"rate limits",[671,1922,1923],{},"Every download is written to the audit log and the sensitive-data access log, with the token that made it.",[553,1925,1536,1926,560],{},[557,1927,1929],{"href":1928},"\u002Fapi\u002Freference#tag\u002Fdocuments\u002FGET\u002Fdocuments\u002F%7Bid%7D\u002Fcontent","Download a document",[562,1931,1933],{"id":1932},"gotchas","Gotchas",[668,1935,1936,1942,1948,1954],{},[671,1937,1938,1941],{},[654,1939,1940],{},"Signing is not available through the API."," A signature is a legal act bound to a person, so documents are signed in the app.",[671,1943,1944,1947],{},[654,1945,1946],{},"Expense reports are read-only apart from decisions."," Reports, receipts and payments are created and changed in the app.",[671,1949,1950,1953],{},[654,1951,1952],{},"Every page of an expense or document list is recorded as an export"," in the audit log, with the record count.",[671,1955,1956,1959,1960,1963],{},[654,1957,1958],{},"Decode files as bytes."," Write the decoded ",[597,1961,1962],{},"content_base64"," straight to a file; do not pass it through a text encoding.",[1965,1966,1967],"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":709,"searchDepth":716,"depth":738,"links":1969},[1970,1971,1976,1981],{"id":564,"depth":738,"text":565},{"id":643,"depth":738,"text":644,"children":1972},[1973,1974,1975],{"id":665,"depth":867,"text":666},{"id":701,"depth":867,"text":702},{"id":1547,"depth":867,"text":1548},{"id":1678,"depth":738,"text":1679,"children":1977},[1978,1979,1980],{"id":1682,"depth":867,"text":1683},{"id":1714,"depth":867,"text":1715},{"id":1817,"depth":867,"text":1818},{"id":1932,"depth":738,"text":1933},"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.","md",null,{},{"icon":81},{"title":205,"description":1982},"8fagASZ___T0dNiLuziLI_AFZlempEjFJeSXeHAzk8M",[1990,1992],{"title":200,"path":201,"stem":202,"description":1991,"icon":203,"children":-1},"Export time entries and timesheets for payroll, record and correct hours, approve time, and read projects, tasks, clients and shift schedules through the API.",{"title":215,"path":216,"stem":217,"description":1993,"icon":210,"children":-1},"How BookYourPTO webhooks push events to your HTTPS endpoint, who can create and own endpoints, what a payload contains and the limits that apply.",1791906546517]