Skip to main content
GET
/
merchant
/
api
/
v1
/
counters
List counters
curl --request GET \
  --url http://api-sandbox.fexpayments.com/merchant/api/v1/counters \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "counters": [
    {
      "id": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
      "merchant_id": "74815c83-e47b-4dc5-aefe-abe4484dd280",
      "name": "Counter 1",
      "status": "active",
      "location": "Floor 2, Register 3",
      "keycloak_client_id": "counter-c1d2e3f4-a5b6-7890-abcd-ef1234567890",
      "webhook_url": "https://pos.example.com/webhooks/payments",
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 3
}

Authorizations

​
Authorization
string
header
required

Keycloak JWT. Roles: admin (platform admin — can register merchants, act on behalf of any merchant), merchant (dashboard user — scoped to their own merchant_id via user attribute mapper), POS terminals use client credentials flow with merchant_id injected via protocol mapper.

Response

List of counters

​
success
boolean
Example:

true

​
counters
object[]
​
total
integer
Example:

3