Skip to main content
GET
/
terminals
Terminals
curl --request GET \
  --url https://quickei.io/pay/sandbox/api/v1/terminals
Retrieve the list of POS terminals configured for your merchant account.

​
Endpoint

GET https://quickei.io/pay/sandbox/api/v1/terminals

​
Query Parameters

​
active_only
boolean
Set to true to return only active terminals. Default: false

​
Response Fields

FieldDescription
idTerminal unique ID
nameTerminal display name
locationPhysical location or description
currency_codeDefault currency for the terminal
is_activeWhether the terminal is currently active
created_atISO 8601 creation timestamp

​
Example Request

GET /merchant-api/pos/v1/terminals?active_only=true
Authorization: Basic {base64_credentials}

​
Success Response 200

{
  "message": {
    "success": ["POS terminals retrieved"]
  },
  "data": {
    "terminals": [
      {
        "id": 1,
        "name": "Counter A",
        "location": "Main Store - Entrance",
        "currency_code": "EUR",
        "is_active": true,
        "created_at": "2024-01-10T09:00:00+00:00"
      },
      {
        "id": 2,
        "name": "Counter B",
        "location": "Main Store - Back",
        "currency_code": "EUR",
        "is_active": true,
        "created_at": "2024-01-10T09:05:00+00:00"
      }
    ]
  }
}