> ## Documentation Index
> Fetch the complete documentation index at: https://developer.quickei.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Terminals

> List configured POS terminals

Retrieve the list of POS terminals configured for your merchant account.

## Endpoint

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

## Query Parameters

<ParamField query="active_only" type="boolean">
  Set to `true` to return only active terminals. Default: `false`
</ParamField>

## Response Fields

| Field           | Description                              |
| --------------- | ---------------------------------------- |
| `id`            | Terminal unique ID                       |
| `name`          | Terminal display name                    |
| `location`      | Physical location or description         |
| `currency_code` | Default currency for the terminal        |
| `is_active`     | Whether the terminal is currently active |
| `created_at`    | ISO 8601 creation timestamp              |

## Example Request

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

## Success Response `200`

```json theme={null}
{
  "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"
      }
    ]
  }
}
```