{
  "info": {
    "_postman_id": "7f87e451-3a68-4fe5-9d1d-8ca1ab3bf6f9",
    "name": "SmartQ.tv Developer API",
    "description": "Official SmartQ.tv Developer API collection. Import this collection plus the SmartQ.tv Developer API environment, set the token once in the environment, then reuse the full endpoint tree across locations and modules.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{token}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.smartq.tv/v1"
    },
    {
      "key": "groupId",
      "value": "YOUR_GROUP_ID"
    },
    {
      "key": "locationId",
      "value": "YOUR_LOCATION_ID"
    },
    {
      "key": "sportsqDate",
      "value": ""
    }
  ],
  "item": [
    {
      "name": "Discovery",
      "item": [
        {
          "name": "Locations",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/locations",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "locations"
              ]
            },
            "description": "List accessible locations, enabled modules, granted endpoints, and refresh metadata."
          }
        },
        {
          "name": "Group Modules",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/modules",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "modules"
              ]
            },
            "description": "Group-level enabled module summary across accessible locations."
          }
        },
        {
          "name": "Location Root",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}"
              ]
            },
            "description": "Location-level root summary and granted endpoints."
          }
        },
        {
          "name": "Location Modules",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/modules",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "modules"
              ]
            },
            "description": "Location-level enabled module summary."
          }
        }
      ]
    },
    {
      "name": "ShiftQ",
      "item": [
        {
          "name": "ShiftQ Overview",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/shiftq",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "shiftq"
              ]
            }
          }
        },
        {
          "name": "ShiftQ Sales",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/shiftq/sales",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "shiftq",
                "sales"
              ]
            }
          }
        },
        {
          "name": "ShiftQ Labor",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/shiftq/labor",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "shiftq",
                "labor"
              ]
            }
          }
        },
        {
          "name": "ShiftQ POS Menu",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/shiftq/pos-menu",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "shiftq",
                "pos-menu"
              ]
            }
          }
        },
        {
          "name": "ShiftQ Clock-Ins",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/shiftq/clock-ins",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "shiftq",
                "clock-ins"
              ]
            }
          }
        },
        {
          "name": "ShiftQ Employees",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/shiftq/employees",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "shiftq",
                "employees"
              ]
            }
          }
        }
      ]
    },
    {
      "name": "SportsQ",
      "item": [
        {
          "name": "SportsQ Guide",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/sportsq?date={{sportsqDate}}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "sportsq"
              ],
              "query": [
                {
                  "key": "date",
                  "value": "{{sportsqDate}}",
                  "disabled": true
                }
              ]
            },
            "description": "Optional query parameter: enable the date query and set YYYY-MM-DD when you want a specific guide day."
          }
        }
      ]
    },
    {
      "name": "MatriQ",
      "item": [
        {
          "name": "MatriQ Overview",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/matriq",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "matriq"
              ]
            }
          }
        },
        {
          "name": "MatriQ Gateway",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/matriq/gateway",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "matriq",
                "gateway"
              ]
            }
          }
        },
        {
          "name": "MatriQ Devices",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/matriq/devices",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "matriq",
                "devices"
              ]
            }
          }
        },
        {
          "name": "MatriQ Provider Available",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/matriq/providerAvailable",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "matriq",
                "providerAvailable"
              ]
            }
          }
        },
        {
          "name": "MatriQ AI Scheduler",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/matriq/aiScheduler",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "matriq",
                "aiScheduler"
              ]
            }
          }
        },
        {
          "name": "MatriQ AI Scheduler Emergency Stop",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reason\": \"Emergency stop requested by operator\"\n}"
            },
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/matriq/aiScheduler/emergency-stop",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "matriq",
                "aiScheduler",
                "emergency-stop"
              ]
            }
          }
        },
        {
          "name": "Provider Available",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/providerAvailable",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "providerAvailable"
              ]
            }
          }
        }
      ]
    },
    {
      "name": "Campaigns",
      "item": [
        {
          "name": "Group Campaigns",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/campaigns",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "campaigns"
              ]
            }
          }
        },
        {
          "name": "Location Campaigns",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/campaigns",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "campaigns"
              ]
            }
          }
        }
      ]
    },
    {
      "name": "OrderBoard",
      "item": [
        {
          "name": "Group OrderBoard",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/orderboard",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "orderboard"
              ]
            }
          }
        },
        {
          "name": "Location OrderBoard",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/{{groupId}}/{{locationId}}/orderboard",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "{{groupId}}",
                "{{locationId}}",
                "orderboard"
              ]
            }
          }
        }
      ]
    }
  ]
}