Retrieves a list of clients with optional filtering, sorting, and pagination.
Endpoint
GET /clientsAuthentication
Required: Authorization header with valid token
Query Parameters
| Parameter | Type | Required | Description | Example |
|---|---|---|---|---|
sortBy | string | No | Field to sort by | updatedAt |
sortDirection | string | No | Sort direction | DESC |
updatedAfter | date-time | No | Filter clients updated after this date | 2024-01-01T00:00:00Z |
search | string | No | Search term for client name/description | construction |
partnerType | string | No | Filter by partner type | INDUSTRY |
status | string | No | Filter by client status | ACTIVE |
page | number | No | Page number (default: 1) | 1 |
limit | number | No | Items per page (default: 20) | 20 |
Response
Success (200)
{
"content": [
"ClientEntity"
],
"total": "number"
}Response Field Descriptions:
content- Array of contract objects (ClientEntity Schematotal- Total number of contracts matching the query criteria
Error (400)
Example Usage
curl -X GET "https://integration-api.ram.syniotec.com/master-data/v1/client-management/clients?partnerType=INDUSTRY&status=ACTIVE&page=1&limit=10" \
-H "Authorization: Bearer YOUR_TOKEN"