---
updatedAt: 2026-07-08T16:17:10.000Z
agentTools:
  projectIndex: https://developers.spoton.com/central-api/llms.txt
---

# Retrieve Orders

Retrieve a list of historical orders for a given location.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Reporting",
    "description": "The Centralized Reporting API provides endpoints for retrieving reporting information.",
    "version": "0.1.0",
    "contact": {
      "name": "SpotOn"
    }
  },
  "paths": {
    "/reporting/v1/locations/{location_id}/orders": {
      "get": {
        "summary": "Retrieve Orders",
        "description": "Retrieve a list of historical orders for a given location.",
        "operationId": "ReportingService_GetOrders",
        "responses": {
          "200": {
            "description": "A successful response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/v1GetOrdersResponse"
                }
              }
            }
          },
          "400": {
            "description": "The request is invalid.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rpcStatus"
                }
              }
            }
          },
          "401": {
            "description": "The request is unauthorized.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rpcStatus"
                }
              }
            }
          },
          "404": {
            "description": "Requested resource or BLID not found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rpcStatus"
                }
              }
            }
          },
          "409": {
            "description": "The request is in conflict with current server state.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rpcStatus"
                }
              }
            }
          },
          "500": {
            "description": "There was an error processing the request.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rpcStatus"
                }
              }
            }
          },
          "default": {
            "description": "An unexpected error response.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/rpcStatus"
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "location_id",
            "description": "SpotOn Location ID",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "from_time",
            "description": "Start time of the order created date time range. Format is RFC 3339.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "to_time",
            "description": "End time of the order created date time range. Format is RFC 3339.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "range",
            "description": "Range for the aggregation. RANGE_LAST_DAY is 24 hours, RANGE_LAST_WEEK is 168 hours, RANGE_LAST_MONTH is 720 hours, and LAST_YEAR is 31,536,000 seconds and doesn't take into account leap-years, leap-seconds.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "enum": [
                "RANGE_UNSPECIFIED",
                "RANGE_LAST_DAY",
                "RANGE_LAST_WEEK",
                "RANGE_LAST_MONTH",
                "RANGE_LAST_YEAR"
              ],
              "default": "RANGE_UNSPECIFIED"
            }
          },
          {
            "name": "multiplier",
            "description": "Multiplier for the range. For example, if range is RANGE_LAST_DAY and multiplier is 2, the filter will return the last 48 hours of data.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "page",
            "description": "Page number. If not provided, the default value is 1.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "per_page",
            "description": "Number of results per page. Maximum is 1000. If not provided, the default value is 100.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int64",
              "maximum": 1000
            }
          },
          {
            "name": "fiscal_date_from",
            "description": "Start date of the fiscal date range. Format is the date portion of RFC 3339 (YYYY-MM-DD).",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "fiscal_date_to",
            "description": "End date of the fiscal date range. Format is the date portion of RFC 3339 (YYYY-MM-DD).",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "last_updated_from",
            "description": "Start time of the order last updated date time range. Format is RFC 3339. Can be used standalone or combined with the from_time/to_time query parameters.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "last_updated_to",
            "description": "End time of the order last updated date time range. Format is RFC 3339. Can be used standalone or combined with the from_time/to_time query parameters.",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          }
        ],
        "tags": [
          "Orders"
        ],
        "security": [
          {
            "OAuth2": [
              "reporting:orders:read"
            ]
          }
        ]
      }
    }
  },
  "security": [
    {
      "bearer": []
    }
  ],
  "servers": [
    {
      "url": "http://api.spoton.com"
    },
    {
      "url": "https://api.spoton.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "bearer": {
        "type": "apiKey",
        "description": "Authentication token, prefixed by Bearer: Bearer <token>",
        "name": "Authorization",
        "in": "header"
      }
    },
    "schemas": {
      "CheckAutoGratuityTax": {
        "type": "object",
        "properties": {
          "tax_id": {
            "type": "string",
            "description": "Unique identifier of auto gratuity tax."
          },
          "tax_name": {
            "type": "string",
            "description": "Name of auto gratuity tax."
          },
          "percentage": {
            "type": "number",
            "format": "double",
            "description": "Percentage of auto gratuity tax."
          },
          "amount": {
            "type": "number",
            "format": "double",
            "description": "Amount of auto gratuity tax."
          }
        },
        "title": "AutoGratuityTax"
      },
      "EmployeeOwnedBy": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "1234567",
            "description": "Unique identifier of the employee."
          },
          "name": {
            "type": "string",
            "example": "John Doe",
            "description": "Name of the employee."
          }
        },
        "title": "OwnedBy"
      },
      "PaymentSurcharge": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the surcharge."
          },
          "name": {
            "type": "string",
            "description": "Name of the surcharge."
          },
          "amount": {
            "type": "number",
            "format": "double",
            "description": "Amount of the surcharge."
          }
        },
        "title": "Surcharge"
      },
      "protobufAny": {
        "type": "object",
        "properties": {
          "@type": {
            "type": "string"
          }
        },
        "additionalProperties": {}
      },
      "rpcStatus": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "format": "int32"
          },
          "message": {
            "type": "string"
          },
          "details": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/protobufAny"
            }
          }
        }
      },
      "v1Check": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the check."
          },
          "payments_uncollected": {
            "type": "number",
            "format": "double",
            "description": "Uncollected payments for the check."
          },
          "gratuity_amount": {
            "type": "number",
            "format": "double",
            "description": "Gratuity amount for the check."
          },
          "auto_gratuity_taxes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CheckAutoGratuityTax"
            },
            "description": "List of auto gratuity taxes."
          },
          "guests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Guest"
            },
            "description": "List of guests in this check."
          }
        },
        "title": "Check"
      },
      "v1Customer": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Customer unique identifier."
          },
          "first_name": {
            "type": "string",
            "description": "Customer first name."
          },
          "last_name": {
            "type": "string",
            "description": "Customer last name."
          },
          "email": {
            "type": "string",
            "description": "Customer email address."
          },
          "phone": {
            "type": "string",
            "description": "Customer phone number."
          },
          "address": {
            "type": "string",
            "description": "Customer street address."
          },
          "city": {
            "type": "string",
            "description": "Customer city."
          },
          "state": {
            "type": "string",
            "description": "Customer state."
          },
          "zip": {
            "type": "string",
            "description": "Customer zip code."
          }
        },
        "title": "Customer"
      },
      "v1Discount": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the discount."
          },
          "name": {
            "type": "string",
            "description": "Name of the discount."
          },
          "amount": {
            "type": "number",
            "format": "double",
            "description": "Amount of the discount."
          },
          "auth_user_id": {
            "type": "string",
            "description": "Identifier of user authorizing the discount."
          },
          "auth_user_name": {
            "type": "string",
            "description": "Name of user authorizing the discount."
          },
          "discount_reason": {
            "type": "string",
            "description": "Reason for discount."
          },
          "order_discount_id": {
            "type": "string",
            "example": "302868",
            "description": "Order-specific identifier of the discount."
          },
          "parent_id": {
            "type": "string",
            "example": "279748645-1",
            "description": "Identifier of the parent the discount belongs to."
          },
          "parent_type": {
            "type": "string",
            "example": "item",
            "description": "Type of the parent the discount belongs to."
          }
        },
        "title": "Discount"
      },
      "v1Employee": {
        "type": "object",
        "properties": {
          "owned_by": {
            "$ref": "#/components/schemas/EmployeeOwnedBy"
          }
        },
        "title": "Employee"
      },
      "v1Fee": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the fee."
          },
          "name": {
            "type": "string",
            "description": "Name of the fee."
          },
          "order_fee_id": {
            "type": "string",
            "example": "5ad100c3-f233-41d2-a97d-b8d549eed05b",
            "description": "Order-specific identifier of the fee."
          },
          "amount": {
            "type": "number",
            "format": "double",
            "example": 1.25,
            "description": "Monetary amount of the fee."
          }
        },
        "title": "Fee"
      },
      "v1GetOrdersResponse": {
        "type": "object",
        "properties": {
          "orders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Order"
            },
            "description": "List of orders.",
            "readOnly": true
          },
          "pagination": {
            "$ref": "#/components/schemas/v1Pagination"
          }
        },
        "title": "GetOrdersResponse"
      },
      "v1Guest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the guest."
          },
          "name": {
            "type": "string",
            "description": "Name of the guest."
          },
          "check_id": {
            "type": "string",
            "description": "Check identifier associated with the guest."
          },
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1LineItem"
            },
            "description": "List of guest line items."
          },
          "void_items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1LineItem"
            },
            "description": "List of guest voided line items."
          }
        },
        "title": "Guest"
      },
      "v1Liability": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the liability."
          },
          "name": {
            "type": "string",
            "description": "Name of the liability."
          },
          "quantity": {
            "type": "number",
            "format": "double",
            "description": "Quantity of the liability."
          },
          "amount": {
            "type": "number",
            "format": "double",
            "description": "Amount of the liability."
          }
        }
      },
      "v1LineItem": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Menu item identifier."
          },
          "name": {
            "type": "string",
            "description": "Name of the item."
          },
          "quantity": {
            "type": "number",
            "format": "double",
            "description": "Quantity of the item."
          },
          "price": {
            "type": "number",
            "format": "double",
            "description": "Price of the item."
          },
          "modifiers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Modifier"
            },
            "description": "List of modifiers belonging to the item."
          },
          "applicable_taxes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1LineItemTaxReference"
            },
            "description": "List of references to the taxes applied to any item."
          },
          "order_item_id": {
            "type": "string",
            "description": "Order item unique identifier."
          },
          "gross_sales_amount": {
            "type": "number",
            "format": "double",
            "example": 0.5,
            "description": "Gross sales amount of the item."
          },
          "net_sales_amount": {
            "type": "number",
            "format": "double",
            "example": 0.5,
            "description": "Net sales amount of the item."
          },
          "void": {
            "$ref": "#/components/schemas/v1Void"
          },
          "inclusive_taxes_amount": {
            "type": "number",
            "format": "double",
            "description": "Inclusive taxes amount of the item."
          },
          "exclusive_taxes_amount": {
            "type": "number",
            "format": "double",
            "description": "Exclusive taxes amount of the item."
          },
          "station_id": {
            "type": "string",
            "example": "1234567",
            "description": "Identifier of the station or terminal associated with this line item. May differ from the order's station ID. Empty when unavailable; does not fall back to the order's station ID.",
            "readOnly": true
          },
          "reporting_category_id": {
            "type": "string",
            "example": "leaf-001",
            "description": "Current reporting category identifier for the menu item. Empty when no reporting category is assigned.",
            "readOnly": true
          },
          "reporting_category_name": {
            "type": "string",
            "example": "Vodka",
            "description": "Current reporting category name for the menu item, not a historical order snapshot. 'Uncategorized' when unassigned.",
            "readOnly": true
          },
          "parent_reporting_category_id": {
            "type": "string",
            "example": "parent-001",
            "description": "Current parent reporting category identifier for the menu item. Empty when no parent reporting category is assigned.",
            "readOnly": true
          },
          "parent_reporting_category_name": {
            "type": "string",
            "example": "Liquor",
            "description": "Current parent reporting category name for the menu item, not a historical order snapshot. 'Uncategorized' when unassigned.",
            "readOnly": true
          }
        },
        "title": "LineItem"
      },
      "v1LineItemTaxReference": {
        "type": "object",
        "properties": {
          "tax_id": {
            "type": "string",
            "example": "6rym5kmjx3ct3de1eheueszosy",
            "description": "Unique identifier of the tax."
          },
          "tax_amount": {
            "type": "number",
            "format": "double",
            "example": 0.5,
            "description": "Total tax amount for the item (inclusive + exclusive)."
          },
          "is_inclusive": {
            "type": "boolean",
            "description": "Indicates whether the tax is inclusive."
          },
          "parent_id": {
            "type": "string",
            "example": "279747574-0",
            "description": "ID of the parent the tax belongs to."
          },
          "parent_type": {
            "type": "string",
            "example": "item",
            "description": "Type of the parent the tax belongs to."
          }
        },
        "title": "TaxReference"
      },
      "v1Modifier": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the modifier."
          },
          "name": {
            "type": "string",
            "description": "Name of the modifier."
          },
          "quantity": {
            "type": "number",
            "format": "double",
            "description": "Quantity of the modifier."
          },
          "price": {
            "type": "number",
            "format": "double",
            "description": "Price of the modifier."
          },
          "prefix": {
            "type": "string",
            "description": "Prefix for the modifier. For example: Extra, Light"
          },
          "order_modifier_id": {
            "type": "string",
            "example": "279563179-10000",
            "description": "Order-specific identifier of the modifier."
          },
          "net_sales_amount": {
            "type": "number",
            "format": "double",
            "example": 0.75,
            "description": "Net sales amount for the modifier."
          },
          "discounts_amount": {
            "type": "number",
            "format": "double",
            "example": -0.25,
            "description": "Discounts amount for the modifier."
          },
          "inclusive_taxes_amount": {
            "type": "number",
            "format": "double",
            "example": 0,
            "description": "Inclusive taxes amount for the modifier."
          },
          "exclusive_taxes_amount": {
            "type": "number",
            "format": "double",
            "example": 0,
            "description": "Exclusive taxes amount for the modifier."
          }
        },
        "title": "Modifier"
      },
      "v1Order": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Unique identifier of the order."
          },
          "location_id": {
            "type": "string",
            "description": "Business location id associated with the order."
          },
          "source": {
            "type": "string",
            "description": "Origin of the order. For example, DoorDash, UberEats, etc."
          },
          "fulfillment_type": {
            "type": "string",
            "description": "Fulfillment type of the order."
          },
          "line_items": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1LineItem"
            },
            "description": "List of line items."
          },
          "payments": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Payment"
            },
            "description": "List of payments."
          },
          "totals": {
            "$ref": "#/components/schemas/v1Totals"
          },
          "discounts": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Discount"
            },
            "description": "List of discounts."
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "description": "Created at timestamp (RFC3339).",
            "readOnly": true
          },
          "last_updated_at": {
            "type": "string",
            "format": "date-time",
            "example": "2021-01-01T00:00:00Z",
            "description": "Last updated at timestamp (RFC3339).",
            "readOnly": true
          },
          "closed_at": {
            "type": "string",
            "format": "date-time",
            "description": "Closed at timestamp (RFC3339).",
            "readOnly": true
          },
          "taxes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Tax"
            },
            "description": "List of taxes."
          },
          "employee": {
            "$ref": "#/components/schemas/v1Employee"
          },
          "table_number": {
            "type": "string",
            "example": "12",
            "description": "Table number associated with the order."
          },
          "guest_count": {
            "type": "integer",
            "format": "int32",
            "example": 4,
            "description": "Number of guests associated with the order."
          },
          "liabilities": {
            "type": "array",
            "example": [
              {
                "amount": 10,
                "id": "1234567",
                "name": "Liability 1",
                "quantity": 1
              }
            ],
            "items": {
              "$ref": "#/components/schemas/v1Liability"
            },
            "description": "List of liabilities."
          },
          "fiscal_date": {
            "type": "string",
            "example": "2026-02-03",
            "description": "Fiscal date of the order (YYYY-MM-DD)."
          },
          "order_time_zone": {
            "type": "string",
            "example": "America/Los_Angeles",
            "description": "Timezone of the order."
          },
          "voided_line_items": {
            "type": "array",
            "example": [
              {
                "id": "1234567",
                "name": "Burger",
                "price": 9.99,
                "quantity": 1,
                "void": {
                  "amount": 9.99,
                  "reason": "customer changed order",
                  "voided_at": "2026-02-03T18:25:43Z"
                }
              }
            ],
            "items": {
              "$ref": "#/components/schemas/v1LineItem"
            },
            "description": "Voided line items for the order, each carrying its own void metadata."
          },
          "checks": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Check"
            },
            "description": "List of checks associated with the order."
          },
          "fees": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/v1Fee"
            },
            "description": "List of fees associated with the order."
          },
          "customer": {
            "$ref": "#/components/schemas/v1Customer"
          },
          "order_type": {
            "type": "string",
            "example": "Dine In",
            "description": "Type of the order."
          },
          "released_at": {
            "type": "string",
            "format": "date-time",
            "example": "2026-02-03T18:25:43Z",
            "description": "Timestamp the order was released at (RFC3339)."
          },
          "open_daypart": {
            "type": "string",
            "example": "Lunch",
            "description": "Daypart for when the order was opened."
          },
          "original_order_number": {
            "type": "string",
            "example": "a9cabf96-5d58-4054-a765-dfd9e4490607",
            "description": "Number of the refunded order, if any"
          },
          "original_order_id": {
            "type": "string",
            "example": "012345678",
            "description": "Unique identifier of the refunded order, if any"
          },
          "station_id": {
            "type": "string",
            "example": "1234567",
            "description": "Identifier of the station or terminal associated with the order. Empty when unavailable.",
            "readOnly": true
          },
          "order_status": {
            "type": "string",
            "example": "OPEN",
            "description": "Raw order status from the source system, preserved without normalization. Empty when unavailable.",
            "readOnly": true
          },
          "order_number": {
            "type": "string",
            "example": "000123",
            "description": "Order number shown on the receipt or an external reference ID.",
            "readOnly": true
          },
          "revenue_center": {
            "type": "string",
            "example": "Dining Room",
            "description": "Revenue center resolved at read time from the location's revenue center mapping: by order type for RPOS orders, by origin for Express orders, falling back to the source value when no mapping exists. \"Unspecified\" when the source value is empty.",
            "readOnly": true
          }
        },
        "title": "Order"
      },
      "v1Pagination": {
        "type": "object",
        "properties": {
          "page_number": {
            "type": "integer",
            "format": "int64",
            "description": "Page number."
          },
          "per_page": {
            "type": "integer",
            "format": "int64",
            "description": "Number of results per page. Maximum is 1000."
          },
          "total_pages": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of pages."
          },
          "total_results": {
            "type": "integer",
            "format": "int64",
            "description": "Total number of results."
          }
        },
        "title": "Pagination"
      },
      "v1Payment": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Payment type."
          },
          "amount": {
            "type": "number",
            "format": "double",
            "description": "Amount of the payment."
          },
          "is_refund": {
            "type": "boolean",
            "description": "Indicates if the payment is a refund."
          },
          "is_void": {
            "type": "boolean",
            "description": "Indicates if the payment is voided."
          },
          "id": {
            "type": "string",
            "description": "Unique identifier of the payment."
          },
          "tips_amount": {
            "type": "number",
            "format": "double",
            "description": "Payment's tips amount."
          },
          "fees_amount": {
            "type": "number",
            "format": "double",
            "description": "Payment fees amount."
          },
          "surcharges": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PaymentSurcharge"
            },
            "description": "List of payment surcharges."
          },
          "employee": {
            "$ref": "#/components/schemas/v1Employee"
          },
          "card_type": {
            "type": "string",
            "description": "Card type used for the payment."
          },
          "last_4_digits": {
            "type": "string",
            "description": "Last four digits of the payment card."
          },
          "tip_deduction_amount": {
            "type": "number",
            "format": "double",
            "description": "Payment tip deduction amount."
          },
          "order_payment_id": {
            "type": "string",
            "example": "046eb7c0-99fa-4a7b-af49-12c1f4859917",
            "description": "Order-specific identifier of the payment."
          },
          "sub_type": {
            "type": "string",
            "example": "DoorDash",
            "description": "Additional detail on the type of payment when the payment is not from a credit card.",
            "readOnly": true
          }
        },
        "title": "Payment"
      },
      "v1Tax": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "example": "6rym5kmjx3ct3de1eheueszosy",
            "description": "Unique identifier of the tax."
          },
          "name": {
            "type": "string",
            "example": "State MI - 20%",
            "description": "Name of the tax."
          },
          "amount": {
            "type": "number",
            "format": "double",
            "description": "Total amount of the tax (inclusive + exclusive). Accumulative per applicable line items."
          },
          "percentage": {
            "type": "number",
            "format": "double",
            "description": "Percentage of the tax."
          },
          "is_inclusive": {
            "type": "boolean",
            "description": "Indicates whether the tax is inclusive."
          },
          "parent_id": {
            "type": "string",
            "example": "279747574-0",
            "description": "Identifier of the parent the tax belongs to."
          },
          "parent_type": {
            "type": "string",
            "example": "item",
            "description": "Type of the parent the tax belongs to."
          }
        },
        "title": "Tax"
      },
      "v1Totals": {
        "type": "object",
        "properties": {
          "subtotal": {
            "type": "number",
            "format": "double",
            "description": "Subtotal amount of the order."
          },
          "tip_total": {
            "type": "number",
            "format": "double",
            "description": "Tip total amount of the order."
          },
          "discounts_total": {
            "type": "number",
            "format": "double",
            "description": "Discounts total amount of the order."
          },
          "tax_total": {
            "type": "number",
            "format": "double",
            "description": "Tax total amount of the order."
          },
          "grand_total": {
            "type": "number",
            "format": "double",
            "description": "Grand total amount of the order."
          },
          "modifiers_amount": {
            "type": "number",
            "format": "double",
            "description": "Modifiers amount of the order."
          },
          "autogratuity_amount": {
            "type": "number",
            "format": "double",
            "description": "Autogratuity amount of the order."
          },
          "fees_revenue_amount": {
            "type": "number",
            "format": "double",
            "description": "Fees revenue amount of the order."
          },
          "payments_amount": {
            "type": "number",
            "format": "double",
            "description": "Payments amount of the order."
          },
          "liabilities_amount": {
            "type": "number",
            "format": "double",
            "description": "Liabilities amount of the order."
          },
          "voids_amount": {
            "type": "number",
            "format": "double",
            "description": "Voids amount of the order."
          },
          "gross_sales_amount": {
            "type": "number",
            "format": "double",
            "description": "Gross sales amount of the order."
          },
          "net_sales_amount": {
            "type": "number",
            "format": "double",
            "description": "Net sales amount of the order."
          },
          "inclusive_taxes_amount": {
            "type": "number",
            "format": "double",
            "description": "Inclusive taxes amount of the order."
          },
          "exclusive_taxes_amount": {
            "type": "number",
            "format": "double",
            "description": "Exclusive taxes amount of the order."
          },
          "has_returns": {
            "type": "boolean",
            "description": "Indicates if the order has returns."
          },
          "inclusive_taxes_collected_amount": {
            "type": "number",
            "format": "double",
            "description": "Inclusive taxes collected amount of the order."
          },
          "exclusive_taxes_collected_amount": {
            "type": "number",
            "format": "double",
            "description": "Exclusive taxes collected amount of the order."
          },
          "taxes_collected_amount": {
            "type": "number",
            "format": "double",
            "description": "Taxes collected amount of the order."
          },
          "facilitator_tax_adjustment_amount": {
            "type": "number",
            "format": "double",
            "description": "Facilitator tax adjustment amount of the order."
          },
          "rounding_amount": {
            "type": "number",
            "format": "double",
            "description": "Payment Rounding amount of the order."
          },
          "items_discounts_amount": {
            "type": "number",
            "format": "double",
            "description": "Items discounts amount of the order."
          },
          "liabilities_discounts_amount": {
            "type": "number",
            "format": "double",
            "description": "Liabilities discounts amount of the order."
          },
          "revenue_amount": {
            "type": "number",
            "format": "double",
            "description": "Revenue amount of the order."
          },
          "credit_card_surcharges_amount": {
            "type": "number",
            "format": "double",
            "description": "Credit card surcharges amount of the order."
          },
          "payments_collected_amount": {
            "type": "number",
            "format": "double",
            "description": "Collected payments amount of the order."
          },
          "payments_uncollected_amount": {
            "type": "number",
            "format": "double",
            "description": "Uncollected payments amount of the order."
          }
        },
        "title": "Totals"
      },
      "v1Void": {
        "type": "object",
        "properties": {
          "voided_at": {
            "type": "string",
            "format": "date-time",
            "example": "2026-02-03T18:25:43Z",
            "description": "Timestamp the item was voided (RFC3339).",
            "readOnly": true
          },
          "voided_by": {
            "$ref": "#/components/schemas/v1Employee"
          },
          "amount": {
            "type": "number",
            "format": "double",
            "example": 9.99,
            "description": "Voided amount of the item."
          },
          "reason": {
            "type": "string",
            "example": "customer changed order",
            "description": "Reason the item was voided."
          },
          "comment": {
            "type": "string",
            "example": "voided per manager approval",
            "description": "Optional free-text comment captured on void."
          }
        },
        "title": "Void"
      }
    }
  }
}
```