Get merchant users

1 import requests 2 3 url = "https://api.koywe.com/api/v1/organizations/org_abc123/merchants/mrc_def456/users" 4 5 querystring = {"page":"1","limit":"10"} 6 7 headers = {"Authorization": "Bearer <token>"} 8 9 response = requests.get(url, headers=headers, params=querystring) 10 11 print(response.json())

1 { 2 "users": [ 3 { 4 "id": "k3u_abc123", 5 "name": "John Doe", 6 "email": "john@example.com", 7 "isActive": true, 8 "lastModifiedRole": "2024-01-20T14:45:00.000Z", 9 "roles": [ 10 { 11 "id": "k3r_user_security_admin", 12 "name": "User Security Admin", 13 "description": "Can manage security settings", 14 "assignedAt": "2024-01-15T10:30:00.000Z", 15 "lastModified": "2024-01-20T14:45:00.000Z" 16 } 17 ] 18 } 19 ], 20 "pagination": { 21 "page": 1, 22 "totalPages": 5, 23 "totalItems": 50 24 } 25 }

Retrieve a paginated list of users for a specific merchant. Requires ORGANIZATION_SETTINGS_VIEW_MERCHANT permission.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path Parameters

organizationIdstringRequired

Organization identifier

merchantIdstringRequired

Merchant identifier

Query Parameters

pagedoubleRequired>=1

Page number

limitdoubleRequired>=1<=100

Number of items per page

namestringOptional

Filter by user name (partial match, case-insensitive).

emailstringOptional

Filter by user email (partial match, case-insensitive).

Response

List of merchant users retrieved successfully

userslist of objects

List of users

paginationobject

Pagination information

Authentication

Path Parameters

Query Parameters

Response

Errors