Toast Restaurants information API

openapi: 3.2.0
info:
  title: Analytics Restaurants information API
  description: 'The analytics API provides an enterprise reporting and analytics service,

    and includes operations that retrieve information for all restaurants, or a

    subset of restaurants, in a management group, create requests for reporting data,

    and retrieve the reporting data.'
  version: 1.0.0
  contact:
    name: Toast developer support
servers:
- url: https://toast-api-server/era/v1
tags:
- name: Restaurants information
  description: The analytics API endpoint for providing information about restaurants in a management group.
paths:
  /restaurants-information:
    get:
      summary: Get management group restaurant information
      description: 'Returns an array of `RestaurantInfo` objects containing the GUID and guest-facing name for each

        restaurant in the associated management group, and whether or not the restaurant is activated, in test mode, or archived.'
      operationId: getManagementGroupRestaurantsInformation
      responses:
        '200':
          description: A JSON array of `RestaurantsGuidName` objects for each restaurant in the management group.
          content:
            application/json:
              schema:
                title: Response
                type: array
                items:
                  $ref: '#/components/schemas/RestaurantsGuidName'
      security:
      - oauth2:
        - enterprise-metrics:read
      tags:
      - Restaurants information
components:
  schemas:
    RestaurantsGuidName:
      description: Information about a restaurant in the management group.
      type: object
      properties:
        restaurantGuid:
          description: 'The identifier assigned by the Toast platform used to identify a restaurant location.

            '
          format: UUID
          type: string
        restaurantName:
          description: The restaurant's name.
          format: string
          type: string
        active:
          description: 'Indicates whether the restaurant is activated or not.


            Valid values:


            * `true` - The restaurant is activated.


            * `false` - The restaurant is deactivated.

            '
          format: boolean
          type: boolean
        testMode:
          description: 'Indicates whether the restaurant is in test mode or not.


            Valid values:


            * `true` - The restaurant is in test mode.


            * `false` - The restaurant is not in test mode.

            '
          format: boolean
          type: boolean
        archived:
          description: 'Indicates whether the restaurant is archived or not.


            Valid values:


            * `true` - The restaurant is archived.


            * `false` - The restaurant is not archived.

            '
          format: boolean
          type: boolean
  securitySchemes:
    oauth2:
      description: "Access to Toast APIs, specific endpoints, \nand specific API endpoint operations is \ncontrolled by the scopes that are associated \nwith your API account. \n\nA full reference for Toast API scopes and \ntheir capabilities can be found in the\n[_Toast Developer Guide_](https://doc.toasttab.com/doc/devguide/apiScopes.html).\n"
      type: oauth2
      flows:
        clientCredentials:
          tokenUrl: https://toast-api-server/authentication/v1/authentication/login
          scopes:
            enterprise-metrics:read: 'Allows reading from the analytics API.

              '
x-components: {}