Terminals
A terminal is a physical payment terminal or an online store. Every transaction carries the terminalID it was made on, so use this endpoint to map transactions to your locations or web shops.
List terminals
GET /api/Terminals
Query parameters
All parameters are optional.
| Parameter | Type | Description |
|---|---|---|
| TerminalId | String | The terminal ID (TID), as shown on transactions in terminalID. |
| AgreementNumber | String | Only terminals on this agreement. |
The Partner API returns only terminals that are valid today. The Merchant API also returns terminals whose validity has ended.
Example request
curl -u "$USERNAME:$API_KEY" \
"https://partner-api.staging.straumur.is/api/Terminals?AgreementNumber=1000123"
Example response
{
"terminals": [
{
"merchantName": "Kaffihúsið ehf.",
"merchantID": "2001045",
"terminalID": "S1F2L001",
"dbaName": "Kaffihúsið Laugavegi",
"city": "Reykjavík",
"country": "ISL",
"mcc": "5814",
"status": 4,
"partnerID": "12"
}
],
"responseDateTime": "2026-10-22T08:30:11Z",
"responseIdentifier": "6d2f0c1a-9b8e-4f7d-8a3c-2e1b0f9d7c65"
}
Get a terminal
GET /api/Terminals/id/{id}
Returns one terminal in terminal, or null if no terminal matches. id is Straumur's internal terminal ID, which the list does not return. To look up a terminal by its TID, use the list with TerminalId.
Terminal fields
| Field | Type | Description |
|---|---|---|
| terminalID | String | The terminal ID (TID). |
| dbaName | String | The store name shown to cardholders. |
| city | String | The store's city. |
| country | String | The store's country, ISO 3166 alpha-3. |
| mcc | String | Merchant category code of the store. |
| status | Integer | Whether the terminal can take payments. See Terminal status. |
| merchantName | String | The merchant's legal name. |
| merchantID | String | The merchant number. |
| partnerID | String | ID of the partner the agreement is linked to, if any. |
| ecomTerminalIdentifier | String | Partner API only. Not used yet; always null. |