---
title: "Get the terminal ID"
description: "Get the unique identifier of the payment terminal to include in your Terminal API requests."
url: "https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/get-the-terminal-id"
source_url: "https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/get-the-terminal-id.md"
canonical: "https://docs.adyen.com/point-of-sale/design-your-integration/terminal-api/get-the-terminal-id"
last_modified: "2026-06-16T16:15:35+02:00"
language: "en"
---

# Get the terminal ID

Get the unique identifier of the payment terminal to include in your Terminal API requests.

[View source](/point-of-sale/design-your-integration/terminal-api/get-the-terminal-id.md)

When you make a Terminal API request, you need to indicate which payment terminal you want to use. To do so, you populate the `POIID` field in the `MessageHeader` with the unique identifier of the payment terminal in the format *\[device model]-\[serial number]*. For example, **P400‑123456789**.

There are several ways to get the unique ID (POIID) of a payment terminal:

## Get the serial number from the terminal

To construct the POIID of the payment terminal:

1. Find the serial number of the payment terminal:

   * On the back of the payment terminal.
   * On the payment terminal screen under **Settings** > **Device info**.

2. Take the device model, for example, **P400**, and combine it with the serial number.

3. Add a dash between the device model and the serial number.

4. Remove any dashes from the serial number.

## Get the serial number from your Customer Area

In your [Customer Area](https://ca-test.adyen.com/):

1. Go to **In-person payments** > **Payment devices**, and select the **Terminals** tab.
2. Select the payment terminal.

## Make an API call

If your integration uses [cloud communications](/point-of-sale/design-your-integration/choose-your-architecture/cloud), you can get the terminal ID with an API call:

1. Make a POST [`/connectedTerminals` ](/point-of-sale/diagnostics/check-cloud-connection/#use-an-api-call)request, specifying your merchant account and optionally a store belonging to that merchant account.
2. In the response, get the `POIID` from the `uniqueTerminalIds` array.\
   This array contains a `POIID` for every terminal that has a live cloud connection and belongs to the specified merchant account or store.

## Use a diagnosis request

If your integration uses [local communications](/point-of-sale/design-your-integration/choose-your-architecture/local), you can get the terminal ID using a diagnosis request.

1. Make a [diagnosis request](/point-of-sale/diagnostics/request-diagnosis) with a placeholder `MessageHeader.POIID`, for example **xxxx-123456789**.\
   The request will fail.

2. In the `DiagnosisResponse`, find the correct `POIID` inside the `MessageHeader`.\
   This is the `POIID` of the terminal that you sent the diagnosis request to.

## Use an Android function

For Android payment terminals with your app installed on the terminal:

* Get the `POIID` of the terminal by calling the following function:

  **Get the terminal ID**

  ```raw
  Settings.Global.getString(context.contentResolver, Settings.Global.DEVICE_NAME)
  ```

## See also

* [Schedule terminal actions](/point-of-sale/android-terminals/deploy-apps/terminal-actions-api)
* [Handle responses](/point-of-sale/error-scenarios/)