Get Charge Anywhere Terminals

Returns the full list of Charge Anywhere terminals provisioned for a given merchant account. Each terminal entry contains its identification string, associated license key, terminal number, store number, and virtual terminal number. This endpoint is used to get a complete view of a merchant's Charge Anywhere terminal inventory.

Endpoint

GET /api/v1/merchant/chargeAnywhere/terminals

Authentication

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

Authorization: Basic {base64(username:password)}

When to use

Use this endpoint when an ISO or support agent needs to view all Charge Anywhere terminals associated with a merchant — for example, before adding a new terminal, during a review of active devices, or when troubleshooting a specific terminal by its number. The terminal list helps confirm which device types have already been provisioned so duplicate entries can be avoided.

Query Parameters

Response

200 OK

{
  "internalMerchantId": "MID-78234",
  "terminals": [
    {
      "identification": "connected",
      "licenseKey": "CA-LIC-A1B2C3D4E5F6",
      "terminalNumber": "T001",
      "terminalStoreNumber": "STORE-01",
      "terminalVNumber": "VT-0091"
    },
    {
      "identification": "connected",
      "licenseKey": "CA-LIC-G7H8I9J0K1L2",
      "terminalNumber": "T002",
      "terminalStoreNumber": "STORE-01",
      "terminalVNumber": "VT-0092"
    }
  ],
  "requestId": 93015,
  "success": true,
  "error": null,
  "validationErrors": []
}

Error Codes

Common Mistakes

• Passing a string value for id — the parameter must be a valid int32 integer
• Not checking success before processing the terminals array — an empty or null array is returned on failure
• Confusing terminalNumber with terminalVNumber — the terminal number is a merchant-facing label, while the V-number identifies the virtual terminal slot
• Using this endpoint to check individual terminal status rather than fetching the credential details — use GET /api/v1/merchant/chargeAnywhere/virtualTerminal for detailed credential retrieval

Related Endpoints

• GET /api/v1/merchant/chargeAnywhere/virtualTerminal — retrieve credentials and connection status for a specific merchant
• GET /api/v1/merchant/chargeAnywhere/licenses — retrieve license records for all Charge Anywhere devices
• POST /api/v1/merchant/chargeAnywhere/terminal — create a new Charge Anywhere terminal for a merchant

Example

curl -X GET "https://hq.staging.netevia.dev/api/v1/merchant/chargeAnywhere/terminals?id=78234" \
  -H "Authorization: Basic $(echo -n 'username:password' | base64)" \
  -H "Content-Type: application/json"