# Devices

A `Device` resource represents a Point-of-Sale terminal. `Devices` are used for [In-Person transactions](/guides/in-person-payments).


## List Devices

 - [GET /devices](https://docs.finix.com/api/devices/listdevices.md): Retrieve a list of . 

For details on how to query endpoints using the available parameters, see Query Parameters.

## Fetch a Device

 - [GET /devices/{device_id}](https://docs.finix.com/api/devices/getdevice.md): Retrieve the details of an existing .

## Update Device

 - [PUT /devices/{device_id}](https://docs.finix.com/api/devices/updatedevice.md): You can either update the configuration of a device or take an action on the device

Terminals must be online and connected to the network in order for the request to be successful.

You can initiate an action on a . Actions supported vary by gateway.

FINIX_V1 and DUMMY_V1 terminals support the following actions:
-  - Activate the device to enable processing
-  - Deactivate the device to disable processing
-  - Cancel any active transaction and return to the idle screen

DATACAP_V1 terminals support the following actions:
-  - Activate the device to enable processing
-  - Deactivate the device to disable processing

TRIPOS_CLOUD_V1 terminals support following actions:
-  - Activate the device to enable processing
-  - Deactivate the device to disable processing
-  - Update the idle message content on the terminal
-  - Remotely reboot the terminal

You can also use a PUT request to update the , , , and  of the . Functionality varies by gateway/device. 

## Check Device Connection

 - [GET /devices/{device_id_connection}](https://docs.finix.com/api/devices/getdeviceconnection.md): To check the connection of the , include  at the end of the request endpoint.

## List Device Metrics

 - [GET /devices/{device_id}/device_metrics](https://docs.finix.com/api/devices/listdevicemetrics.md): Finix collects and analyzes data from payment devices and terminals to generate logs, known as  objects. Each  log provides insights into device health, network connectivity, and payment processing performance.

Use this endpoint to retrieve a device's  logs.

For details on how to query endpoints using the available parameters, see Query Parameters.


## Create a Device

 - [POST /merchants/{merchant_id}/devices](https://docs.finix.com/api/devices/createmerchantdevice.md): Create a  under a .