List terminals
curl -X GET "https://test-api.kashier.io/v2/terminals"{ "terminals": [ { "_id": "string", "terminalId": "string", "serialNo": "string", "brandModel": "string", "merchantPayformanceId": "string", "branchName": "string", "address": "string", "status": "active", "mode": "test", "communicationMethod": "data", "limits": {}, "createdAt": "string" } ], "pagination": { "total": 0, "limit": 0, "page": 0, "pages": 0 }}Retrieves the POS terminals registered on your merchant account. The list can be filtered by terminal ID, serial number, branch, label, status, and mode, and is paginated and sortable.
Authorization
secretKey Merchant secret key used to identify the merchant, obtained from Kashier's dashboard. Pass the raw secret key value in the Authorization header (NOT a "Bearer" token).
In: header
Query Parameters
Filter by terminal ID (ISO 8583 DE 41).
Filter by terminal serial number.
Comma-separated branch IDs to filter by.
Comma-separated label IDs to filter by.
Filter by terminal status.
Value in
- "active"
- "inactive"
Filter by terminal mode. A test terminal never touches the live card networks.
Value in
- "test"
- "live"
Filter by merchant ID, e.g. YOUR_MID. Useful when your account has connected accounts.
Quick search keyword.
Field name to sort by, e.g. createdAt.
Sorting direction: 1 = ascending, -1 = descending.
Value in
- 1
- -1
Number of records per page. Default: 20.
Page number. Default: 1.
Response Body
application/json
application/json
application/json
application/json
application/json