MOmollie
Terminals API

Get terminal

Retrieve a single terminal by its ID.

🔑 Access with

API key

Advanced access token with terminals.read

OAuth access with terminals.read

get/terminals/{terminalId}

Request

  • Base URL
    https://api.mollie.com/v2
  • URL
    https://api.mollie.com/v2/terminals/{terminalId}
  • Auth
    • HTTP bearer
    • or HTTP bearer
    • or OAuth 2
      Authorization code: https://my.mollie.com/oauth2/authorize
      Token URL: https://api.mollie.com/oauth2/tokens scopes: terminals.read

Query parameters

testmodeboolean

Most API credentials are specifically created for either live mode or test mode. In those cases the testmode query parameter must not be sent. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting the testmode query parameter to true.

Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.

Response

The terminal object.

resourcestring required

Indicates the response contains a terminal object. Will always contain the string terminal for this endpoint.

idstring required

The identifier uniquely referring to this terminal. Example: term_7MgL4wea46qkRcoTZjWEH.

modestring required

Whether this entity was created in live mode or in test mode.

Possible values: live test

descriptionstring required

A short description of the terminal. The description can be used as an identifier for the terminal. Currently, the description is set when the terminal is initially configured. It will be visible in the Mollie Dashboard, and it may be visible on the device itself depending on the device.

statusstring required

The status of the terminal.

Possible values: pending active inactive

brandstring nullable required

The brand of the terminal.

Possible values: PAX Tap

modelstring nullable required

The model of the terminal. For example for a PAX A920, this field's value will be A920.

Possible values: A35 A77 A920 A920Pro IM30 Tap

serialNumberstring nullable required

The serial number of the terminal. The serial number is provided at terminal creation time.

currencystring required

The currency configured on the terminal, in ISO 4217 format. Currently most of our terminals are bound to a specific currency, chosen during setup.

profileIdstring required

The identifier referring to the profile this entity belongs to.

Most API credentials are linked to a single profile. In these cases the profileId must not be sent in the creation request. For organization-level credentials such as OAuth access tokens however, the profileId parameter is required.

createdAtstring required

The entity's date and time of creation, in ISO 8601 format.

updatedAtstring required

The entity's date and time of creation, in ISO 8601 format.

Example response

{
  "id": "term_vytxeTZskVKR7C7WgdSP3d",
  "mode": "live",
  "description": "Main Terminal",
  "status": "active",
  "brand": "PAX",
  "model": "A920",
  "serialNumber": "1234567890",
  "currency": "EUR",
  "profileId": "pfl_5B8cwPMGnU",
  "createdAt": "2024-03-20T09:13:37+00:00",
  "updatedAt": "2025-03-20T09:13:37+00:00",
  "_links": {
    "self": {
      "href": "https://...",
      "type": "application/hal+json"
    },
    "documentation": {
      "href": "https://...",
      "type": "application/hal+json"
    }
  }
}

Changes

No recorded changes to this operation across all 2 revisions of this API.