# POS Terminal Management API

**Provider:** POS Terminal Management
**Category:** payments
**Base URL:** `https://postfmapi-test.adyen.com/postfmapi/terminal/v1`
**Auth:** api-key — `X-API-Key: YOUR_API_KEY`
**Rate Limit:** Based on contract
**Free Tier:** No
**Pricing:** Enterprise / contact sales (subscription)
**Docs:** https://api.apis.guru/v2/specs/adyen.com:TfmAPIService/1.json

## Description

This API provides endpoints for managing your point-of-sale (POS) payment terminals. You can use the API to obtain information about a specific terminal, retrieve overviews of your terminals and stores, and assign terminals to a merchant account or store.

For more information, refer to Assign terminals.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| POST | `https://postfmapi-test.adyen.com/postfmapi/terminal/v1/assignTerminals` | Assign terminals |
| POST | `https://postfmapi-test.adyen.com/postfmapi/terminal/v1/findTerminal` | Get the account or store of a terminal |
| POST | `https://postfmapi-test.adyen.com/postfmapi/terminal/v1/getStoresUnderAccount` | Get the stores of an account |
| POST | `https://postfmapi-test.adyen.com/postfmapi/terminal/v1/getTerminalDetails` | Get the details of a terminal |
| POST | `https://postfmapi-test.adyen.com/postfmapi/terminal/v1/getTerminalsUnderAccount` | Get the list of terminals |

## Authentication

API key in the X-API-Key header

```
X-API-Key: YOUR_API_KEY
```

## Sample Request

```bash
curl 'https://postfmapi-test.adyen.com/postfmapi/terminal/v1/assignTerminals' \
  -H 'X-API-Key: YOUR_API_KEY'
```

## Sample Response

```json
{}
```

## Pricing Details

Paid. Adyen POS terminal management API; pricing via Adyen merchant account.

---

*Source: [API Map](https://apimap.dev/apis/pos-terminal-management/) — CC BY 4.0*