Get the aggregated sales reporting data

Returns the aggregated sales reporting data for the specified report request GUID.

Specify the reportRequestGuid for the data.

Specify whether to include the guest-facing restaurant names.

Securityoauth2
Request
path Parameters
reportRequestGuid
required
string

The Toast platform identifier for the data request.

query Parameters
fetchRestaurantNames
boolean

Specifies whether the data includes the guest-facing restaurant name. The guest-facing restaurant name is not returned by default.

Valid values:

  • true - The guest-facing restaurant name is returned with the data.

  • false - The guest-facing restaurant name is not returned with the data.

Responses
200

The aggregated sales reporting data.

202

The Toast platform is in the process of gathering the reporting data. Try the request again at a later time.

404

An unexpected error occurred. Refer to the message attached to this error for more information.

409

The Toast platform was unable to process the request. Request a new reportRequestGuid and try again.

500

An unexpected internal error occurred. The requestId attached to this error can be referenced by the Toast support team.

504

The Toast platform was unable to process the request because internal services took too long to process, resulting in a timeout.

get/metrics/{reportRequestGuid}
Request samples
curl -i -X GET \
  'https://toast-api-server/era/v1/metrics/{reportRequestGuid}?fetchRestaurantNames=true' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>'
Response samples
application/json
{
  • "restaurantGuid": "string",
  • "businessDate": "string",
  • "guestCount": 0,
  • "voidOrdersCount": 0,
  • "discountOrderCount": 0,
  • "ordersCount": 0,
  • "openOrderCount": 0,
  • "closedOrderCount": 0,
  • "netSalesAmount": 0,
  • "grossSalesAmount": 0,
  • "discountAmount": 0,
  • "voidOrdersAmount": 0,
  • "refundAmount": 0,
  • "avgOrderValue": 0,
  • "revenueCenter": "string",
  • "diningOption": "string",
  • "orderSource": null,
  • "businessHour": "string",
  • "hourlyJobTotalHours": "string",
  • "hourlyJobTotalPay": "string",
  • "hourlyJobSalesPerLaborHour": "string",
  • "restaurantName": "string"
}