List terminal devices

List all terminal devices registered for the authenticated merchant. Use this endpoint to discover device IDs before initiating a terminal payment.

Related endpoints

• GET /terminal-devices/{id} — Retrieve a terminal device

Common errors

• 401 unauthenticated — missing, malformed, or revoked API key.

Pagination

Offset-based with limit (default 25, max 100) and offset. The response pagination block includes total and hasMore. See the pagination guide for SDK auto-paging helpers.

curl "https://api.revkeen.com/v2/terminal-devices" \  -H "x-api-key: $REVKEEN_API_KEY"

{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "device_name": "string",
      "terminal_serial": "string",
      "terminal_ip": "string",
      "platform": "macos",
      "status": "online",
      "terminal_paired": true,
      "terminal_reachable": true,
      "app_version": "string",
      "last_heartbeat_at": "string"
    }
  ],
  "meta": {
    "count": 0
  }
}

{
  "error": "string",
  "message": "string"
}