Skip to main content

​
Purpose

Allows you to check printer, reminder, and status information by retrieving all stations in your POS and kitchen flows in a single call.

​
HTTP Request

GET https://integrations.clopos.com/open-api/v2/stations

​
Authorization

Required headers:
  • x-token

​
Query Parameters

​
status
integer
Filter by station status (1 = active, 0 = inactive).
​
can_print
boolean
Filter stations that can redirect to a printer.
​
page
integer
default:"1"
Page number for pagination.
​
limit
integer
default:"50"
Number of stations to return (1-200).

​
Request Example

curl -X GET "https://integrations.clopos.com/open-api/v2/stations?status=1&can_print=true" \
  -H "x-token: oauth_example_token" \

​
Response

​
200 OK — List of stations

{
  "success": true,
  "data": [
    {
      "id": "kitchen",
      "name": "Kitchen",
      "status": 1,
      "can_print": true,
      "reminder_enabled": true,
      "description": "Primary hot line",
      "created_at": "2024-01-20T13:00:00Z",
      "updated_at": "2024-01-20T15:00:00Z"
    },
    {
      "id": "bar",
      "name": "Bar",
      "status": 1,
      "can_print": true,
      "reminder_enabled": false,
      "description": "Drink station",
      "created_at": "2024-01-18T09:10:00Z",
      "updated_at": "2024-01-19T17:45:00Z"
    }
  ],
  "total": 4,
  "time": 19,
  "timestamp": "2024-01-20T15:10:00Z"
}

​
401 Unauthorized — Authorization missing

{
  "success": false,
  "error": "unauthorized",
  "message": "Missing authentication headers"
}

​
Field Reference

​
Top-level fields

FieldTypeDescription
successbooleanSuccess status of the request.
dataarrayStation objects.
totalnumberTotal number of stations.
timenumberResponse time.
timestampstringISO 8601 date.

​
Station object

FieldTypeDescription
idstringStation identifier.
namestringStation name.
statusinteger1 = active, 0 = inactive.
can_printbooleanCan be redirected to a printer.
reminder_enabledbooleanIs reminder notification on?
descriptionstringOptional description.
created_atstringCreation time.
updated_atstringLast update time.

​
Notes

  • The can_print=true parameter returns only stations that can print receipts; you can use false for digital-only points like kitchen screens.
  • If the reminder feature (reminder_enabled) is off, “not sent to station” warnings will not appear on the terminal.
  • The active/inactive status of stations affects product routing on the POS side; inactive stations are not assigned to new orders.
  • Adjust pagination parameters (page, limit) for performance in large restaurant chains; it is generally not necessary for a single branch.