Get Non-POS Equipment Catalog

Returns the catalog of non-POS peripheral equipment available for merchant boarding within the authenticated ISO's configuration. Non-POS equipment includes accessories such as receipt printers, external PIN pads, cash drawers, and other devices that complement a merchant's primary POS terminal. Each catalog entry contains an ID, name, and description. No query parameters are required — the list is automatically scoped to the ISO account.

Endpoint

GET /api/v1/equipment/regular

Authentication

Basic HTTP Authentication required.
Encode username:password in Base64 and pass in the Authorization header:

Authorization: Basic {base64(username:password)}

When to use

Call this endpoint to populate a peripheral equipment selection list during merchant boarding or equipment management workflows. Always fetch the catalog before submitting POST /api/v1/equipment/regular (the POST version of this path) to ensure the equipmentId is valid for your ISO. This catalog is separate from the POS terminal catalog and contains only non-terminal devices.

Response

200 OK

{
  "data": [
    {
      "id": 31,
      "name": "Epson TM-T88VI",
      "description": "High-speed thermal receipt printer with USB and Ethernet connectivity"
    },
    {
      "id": 35,
      "name": "Ingenico iPP320",
      "description": "Countertop PIN pad with EMV chip and NFC support, for use with existing POS systems"
    },
    {
      "id": 39,
      "name": "APG Vasario Cash Drawer",
      "description": "Standard cash drawer compatible with most POS receipt printers via RJ-11 port"
    },
    {
      "id": 42,
      "name": "Honeywell Voyager Barcode Scanner",
      "description": "Single-line laser barcode scanner for retail POS integration"
    }
  ],
  "status": "OK",
  "error": null,
  "warning": null,
  "validationResults": [],
  "requestId": 51034
}

Error Codes

Common Mistakes

• Using IDs from this catalog in the POS equipment add endpoint (POST /api/v1/equipment/equipmentpos) — use these IDs only with POST /api/v1/equipment/regular
• Confusing the GET and POST versions of /api/v1/equipment/regular — the GET returns the catalog of available items, while the POST adds a selected item to a merchant's application
• Hard-coding equipment IDs across environments — IDs may differ between staging and production; always fetch the catalog dynamically

Related Endpoints

• POST /api/v1/equipment/regular — add a non-POS equipment item from this catalog to a merchant application
• GET /api/v1/equipment/pos — retrieve the POS terminal equipment catalog
• GET /api/v1/equipment/funders — retrieve the list of available funders for equipment financing
• GET /api/v1/merchant/equipment — view all equipment (POS and non-POS) assigned to a specific merchant

Example

curl -X GET "https://hq.staging.netevia.dev/api/v1/equipment/regular" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)" \
  -H "Content-Type: application/json"