--- title: Access Goodeats sales via API description: The SumUp POS API allows retrieving new Goodeats orders and updating their statuses. The following diagram shows the data flow for Goodeats integrations. New sales can be fetched by polling the API or --- [Skip to content](https://support.thegoodtill.com/access-goodeats-sales-via-api#main-content) English Show submenu for translations ![sumup logo-modified.png\]](https://support.thegoodtill.com/hs-fs/hubfs/sumup%20logo-modified.png?height=40&name=sumup%20logo-modified.png) - [Default HubSpot Blog](https://thegoodtill-8238028.hs-sites.com/blog) Open main navigation Close main navigation - [Default HubSpot Blog](https://thegoodtill-8238028.hs-sites.com/blog) - English Show submenu for translations - Home Home Hello. How can we help you? - There are no suggestions because the search field is empty. 1. [Support Knowledge Base](https://support.thegoodtill.com/?hsLang=en) 2. [Integrations](https://support.thegoodtill.com/integrations?hsLang=en) 3. [Custom](https://support.thegoodtill.com/integrations?hsLang=en#custom) # Access Goodeats sales via API The SumUp POS API allows retrieving new Goodeats orders and updating their statuses. ### Data flow The following diagram shows the data flow for Goodeats integrations. New sales can be fetched by polling the API or by receiving webhook notifications. You can then update the order status via the API (eg to state that a delivery has been completed). Order statuses can be updated from the POS or Goodeats terminal, so you should also poll or listen to changes in the order state which do not originate from your application. See the following article for a full list of [order states](https://support.thegoodtill.com/web-order-states?hsLang=en). ![Access Goodeats sales API](https://support.thegoodtill.com/hs-fs/hubfs/Access%20Goodeats%20sales%20API.png?width=688&name=Access%20Goodeats%20sales%20API.png) **Orders can be cancelled after creation** Orders can be rejected before being accepted or cancelled any time before being marked as completed. Please ensure you are handling these events to prevent actioning orders which have been rejected or cancelled. ### API Please see the following article for an [overview of the API](https://support.thegoodtill.com/support/api?hsLang=en). You can interact with Goodeats orders via the following API methods: - [Sale-GetSales](https://apidoc.thegoodtill.com/#api-Sale-GetSales) - Get the details (items, customer, delivery address) for a sale by ID. - [ExternalSale-GetSalesStatuses](https://apidoc.thegoodtill.com/#api-ExternalSale-GetSalesStatuses) - Get a list outstanding and recently completed sales, including their status. - [ExternalSale-GetSale](https://apidoc.thegoodtill.com/#api-ExternalSale-GetSale) - Get the status of a single sale. - [ExternalSale-UpdateSaleStatus](https://apidoc.thegoodtill.com/#api-ExternalSale-UpdateSaleStatus) - Update the status of a sale. When using the ExternalSale methods, you will need to add an additional header to the requests: ``` Vendor-Id: gtc ``` If you are building an integration for multiple customers, you will need a set of credentials per customer. ### Webhooks You can use webhooks to be notified of new sales and sale status updates without polling. Please see the following article for an [overview of webhooks](https://support.thegoodtill.com/support/webhook?hsLang=en). The following events may be relevant to your integration: - sale.completed - A new sale has been created - sale.web\_order\_status\_updated - The status of a web sale has been updated ### Test accounts We can provide a test account which will allow you to place Goodeats orders and interact with them via the API. Please contact pos.support.uk.ie@sumup.com with some details about your planned integration and the customer(s) you're working with.   - [Front End](https://support.thegoodtill.com/front-end?hsLang=en#main-content) - [Download And Login](https://support.thegoodtill.com/front-end?hsLang=en#download-and-login) - [Sales](https://support.thegoodtill.com/front-end?hsLang=en#sales) - [Tables](https://support.thegoodtill.com/front-end?hsLang=en#tables) - [Options](https://support.thegoodtill.com/front-end?hsLang=en#options) - [App Refresh](https://support.thegoodtill.com/front-end?hsLang=en#app-refresh) - [FAQ](https://support.thegoodtill.com/front-end?hsLang=en#faq) - [Tips](https://support.thegoodtill.com/front-end?hsLang=en#tips) - [Delivery](https://support.thegoodtill.com/front-end?hsLang=en#delivery) - [Refunds](https://support.thegoodtill.com/front-end?hsLang=en#refunds) - [Ticket/Receipt printouts](https://support.thegoodtill.com/front-end?hsLang=en#ticket-receipt-printouts) - [Back End](https://support.thegoodtill.com/back-end?hsLang=en#main-content) - [Dashboard](https://support.thegoodtill.com/back-end?hsLang=en#dashboard) - [Products](https://support.thegoodtill.com/back-end?hsLang=en#products) - [Ingredients](https://support.thegoodtill.com/back-end?hsLang=en#ingredients) - [Sales](https://support.thegoodtill.com/back-end?hsLang=en#sales) - [Customers](https://support.thegoodtill.com/back-end?hsLang=en#customers) - [Setup](https://support.thegoodtill.com/back-end?hsLang=en#setup) - [Users](https://support.thegoodtill.com/back-end?hsLang=en#users) - [Add-ons](https://support.thegoodtill.com/back-end?hsLang=en#add-ons) - [Settings](https://support.thegoodtill.com/back-end?hsLang=en#settings) - [Change Store](https://support.thegoodtill.com/back-end?hsLang=en#change-store) - [Logout](https://support.thegoodtill.com/back-end?hsLang=en#logout) - [Reports](https://support.thegoodtill.com/back-end?hsLang=en#reports) - [Hardware](https://support.thegoodtill.com/hardware?hsLang=en#main-content) - [Printer Setup](https://support.thegoodtill.com/hardware?hsLang=en#printer-setup) - [Printer Troubleshooting](https://support.thegoodtill.com/hardware?hsLang=en#printer-troubleshooting) - [SumUp](https://support.thegoodtill.com/hardware?hsLang=en#sumup) - [Zettle](https://support.thegoodtill.com/hardware?hsLang=en#zettle) - [PaymentSense](https://support.thegoodtill.com/hardware?hsLang=en#paymentsense) - [Supported Hardware](https://support.thegoodtill.com/hardware?hsLang=en#supported-hardware) - [Scanners](https://support.thegoodtill.com/hardware?hsLang=en#scanners) - [iPad](https://support.thegoodtill.com/hardware?hsLang=en#ipad) - [Modules](https://support.thegoodtill.com/modules?hsLang=en#main-content) - [Advanced Stock](https://support.thegoodtill.com/modules?hsLang=en#advanced-stock) - [Pro](https://support.thegoodtill.com/modules?hsLang=en#pro) - [Advanced Loyalty](https://support.thegoodtill.com/modules?hsLang=en#advanced-loyalty) - [KDS](https://support.thegoodtill.com/modules?hsLang=en#kds) - [Integrations](https://support.thegoodtill.com/integrations?hsLang=en#main-content) - [Built-In](https://support.thegoodtill.com/integrations?hsLang=en#built-in) - [Third Party](https://support.thegoodtill.com/integrations?hsLang=en#third-party) - [Custom](https://support.thegoodtill.com/integrations?hsLang=en#custom) - [Reporting](https://support.thegoodtill.com/reporting?hsLang=en#main-content) - [Advanced Reports](https://support.thegoodtill.com/reporting?hsLang=en#advanced-reports) - [Reports](https://support.thegoodtill.com/reporting?hsLang=en#reports) - [Reporting FAQs](https://support.thegoodtill.com/reporting?hsLang=en#reporting-faqs) - [Goodeats](https://support.thegoodtill.com/goodeats?hsLang=en#main-content) - [Goodeats - Table Ordering](https://support.thegoodtill.com/goodeats?hsLang=en#goodeats-table-ordering) - [Goodeats - Delivery](https://support.thegoodtill.com/goodeats?hsLang=en#goodeats-delivery) - [Fulfilment Options](https://support.thegoodtill.com/goodeats?hsLang=en#fulfilment-options) - [Stripe](https://support.thegoodtill.com/goodeats?hsLang=en#stripe) - [Goodeats](https://support.thegoodtill.com/goodeats?hsLang=en#goodeats) - [Payment Options](https://support.thegoodtill.com/goodeats?hsLang=en#payment-options) - [Extras](https://support.thegoodtill.com/extras?hsLang=en#main-content) - [Extras](https://support.thegoodtill.com/extras?hsLang=en#extras) - [Resources](https://support.thegoodtill.com/extras?hsLang=en#resources) - [Redirects](https://support.thegoodtill.com/extras?hsLang=en#redirects) - [MISC](https://support.thegoodtill.com/extras?hsLang=en#misc) - [Deposit Return Scheme](https://support.thegoodtill.com/extras?hsLang=en#deposit-return-scheme) - [System scenarios](https://support.thegoodtill.com/system-scenarios?hsLang=en) - [SumUp Connect](https://support.thegoodtill.com/sumup-connect?hsLang=en) - [Default HubSpot Blog](https://thegoodtill-8238028.hs-sites.com/blog) [![Chill listening crop-3](https://support.thegoodtill.com/hs-fs/hubfs/sumup%20logo-modified.png?width=24&height=24&name=sumup%20logo-modified.png "Chill listening crop-3")](http://thegoodtill.com) SumUp Point of Sale Support Copyright © 2026, SumUp