Get Contracts

Retrieves a list of contracts with optional filtering, sorting, and pagination.

Endpoint

GET /contracts

Authentication

Required: Authorization header with valid token

Query Parameters

ParameterTypeRequiredDescriptionExample
sortBystringNoField to sort byupdatedAt
sortDirectionstringNoSort directionDESC
updatedAfterdate-timeNoFilter contracts updated after this date2024-01-01T00:00:00Z
searchstringNoSearch term for contract title/descriptionconstruction
clientIduuidNoFilter by specific client75f18aa7-b0aa-4d2c-b104-b513bec82a5f
statusstringNoFilter by contract statusIN_PROGRESS
pagenumberNoPage number (default: 1)1
limitnumberNoItems per page (default: 20)20

Response

Success (200)

{
  "content": [
    "ContractEntity"
  ],
  "total": "number"
}

Response Field Descriptions:

  • content - Array of contract objects (ContractEntity Schema)
  • total - Total number of contracts matching the query criteria

Example Usage

curl -X GET "https://integration-api.ram.syniotec.com/master-data/v1/contract-management/contracts" \
  -H "Authorization: Bearer YOUR_TOKEN"