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>
Query parameters
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.
The limit parameter is used for pagination. It specifies the maximum number of entries to return in a single page of results. Max 100.
Filter by terminal name
Filter by terminal status
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"
}
]
}Changes
No recorded changes to this endpoint across all 4 revisions of this API.