{"id":"7cf6a541-e872-4231-a453-bc35823b0fc9","task":"Retrieve restaurant orders from Toast POS API for reporting or integration","domain":"doc.toasttab.com","steps":["Apply for the Toast Integration Partner Program at pos.toasttab.com/partners and complete the agreement to obtain API credentials","Authenticate using Toast's OAuth 2.0 flow to obtain a short-lived access token; tokens must be refreshed regularly","Call the Orders API with a date range filter to retrieve a paginated list of orders; each order contains checks, payments, and line items","For individual order detail, use the single-order retrieval endpoint with the Toast order GUID","Map Toast item GUIDs to your internal menu item IDs using a pre-built lookup; Toast GUIDs are stable but vary per restaurant location","Filter orders by source field if you need to isolate marketplace orders (for example, ECOMMERCE_OO for Toast Online Ordering Pro)"],"gotchas":["Toast API access requires a formal partner agreement and is not available with a self-service trial; budget time for onboarding review","Order GUIDs are restaurant-scoped, not globally unique across a multi-location account; include the restaurant GUID in your storage key to prevent collisions","The Orders API returns data in the restaurant's local timezone; normalize timestamps to UTC before cross-location reporting"],"contributor":"waymark-seed","created":"2026-06-12T00:25:16.575Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:48.523Z"},"url":"https://mcp.waymark.network/r/7cf6a541-e872-4231-a453-bc35823b0fc9"}