Terminals
List terminals
List all terminals (POS devices) from your account.
Required scope: <code style="background:#e8f0fe;color:#1a73e8;padding:2px 8px;border-radius:12px;font-size:0.85em">terminal:read</code>
get/terminal
Query parameters
cursorstring
The cursor parameter is used for pagination. It specifies the pointer to the start of the next set of results in a sequence of paginated data. Typically, this is a unique identifier of the last item from the previous response. If not provided, the API fetches the first page of results.
limitnumber
The limit parameter is used for pagination. It specifies the maximum number of entries to return in a single page of results. Max 100.
namestring
Filter by terminal name
status'ACTIVE' | 'INACTIVE'
Filter by terminal status
modelstring
Filter by terminal model
Response
OK
Example response
{
"metadata": {
"next_cursor": "lL_j7ilk7rc",
"count": 10
},
"data": [
{
"id": "458b2fc4-3092-4de3-abd4-fe1600c09420",
"serial_number": "123-456-789",
"name": "Terminal Checkout 1",
"status": "ACTIVE",
"acquirer": "VERIFONE",
"model": "V240m",
"last_transaction_at": "2025-08-05T13:44:29Z",
"created_at": "2025-08-05T13:44:29Z"
}
]
}