Get Warranties

With this service, you can filter warranty data. The parameters you enter will be used to search the database with the 'like' operator. All matching records will be returned, and the search is case-insensitive.
If multiple parameters are provided, the search will be conducted using the 'and' operator.

Request

curl --location --request GET '<BASE_URL>/individual-customers/warranty?page=1&size=10'
     --header 'Content-Type: application/json'
     --header 'Authorization: <jwtToken>'

Example with date filters:

curl --location --request GET '<BASE_URL>/individual-customers/warranty?warrantyStartDateFrom=2024-01-01&warrantyStartDateTo=2024-12-31'
     --header 'Content-Type: application/json'
     --header 'Authorization: <jwtToken>'

Info

Here are examples of acceptable phone number formats:

• 544 333 22 11
• 5443332211
• +905443332211
• 905443332211
• 05443332211

Request Parameters

Parameter	Type	Required	Description
page	Integer	No	Used for pagination. The default value and minimum value is 1.
size	Integer	No	Used for pagination. The default value is 10. Min 1 - Max 200
firstName	String	No	The customer's first name.
lastName	String	No	The customer's last name.
email	String	No	The customer's email address.
phone	String	No	The customer's phone number.
warrantyStartDateFrom	String	No	Filter warranties by start date (format: yyyy-MM-dd). Returns warranties where warranty start date is on or after this date. Example: 2024-01-01
warrantyStartDateTo	String	No	Filter warranties by start date (format: yyyy-MM-dd). Returns warranties where warranty start date is on or before this date. Example: 2024-12-31

Date Filtering

• warrantyStartDateFrom: Filters by warranty start date (warrantyStartDate >= provided date)
• warrantyStartDateTo: Filters by warranty start date (warrantyStartDate <= provided date)
• Both filters can be used together to find warranties within a specific warranty start date range
• Date format must be yyyy-MM-dd (e.g., 2024-01-15)

Response

{
  "content": [
    {
      "customer": {
        "firstName": "Ahmet",
        "lastName": "Arslan",
        "email": "example@egaranti.com",
        "emailVerified": false,
        "phoneVerified": true,
        "phone": "+905443332211"
      },
      "product": {
        "name": "Erica El Mikseri Kırmızı",
        "category": "Entegrasyon",
        "brand": "Fakir",
        "model": "",
        "warrantyStartDate": "2024-08-15",
        "warrantyExpireDate": "2025-08-15",
        "externalOrderId": "123",
        "extendedWarranties": [
          {
            "id": 456,
            "externalProductName": "2 Yıllık Plan",
            "brand": "Fakir",
            "warrantyStartDate": "2025-08-15",
            "warrantyExpireDate": "2027-08-15"
          }
        ]
      }
    },
    {
      "customer": {
        "firstName": "Ahmet",
        "lastName": "Arslan",
        "email": "example@egaranti.com",
        "emailVerified": false,
        "phoneVerified": true,
        "phone": "+905443332211"
      },
      "product": {
        "name": "Erica El Mikseri Kırmızı",
        "category": "Entegrasyon",
        "brand": "Fakir",
        "model": "",
        "warrantyStartDate": "2024-08-15",
        "warrantyExpireDate": "2025-08-15",
        "externalOrderId": "1231",
        "extendedWarranties": []
      }
    }
  ],
  "totalPages": 1,
  "totalElements": 2,
  "size": 10,
  "page": 1,
  "empty": false
}

Response Fields

Product Object

Field	Type	Description
name	String	The product name
category	String	The product category
brand	String	The product brand
model	String	The product model
warrantyStartDate	String	Warranty start date in yyyy-MM-dd format
warrantyExpireDate	String	Warranty expiration date in yyyy-MM-dd format
externalOrderId	String	The external order identifier
extendedWarranties	Array	List of extended warranties associated with this product (may be empty)

Extended Warranty Object

Field	Type	Description
id	Integer	The extended warranty unique identifier
externalProductName	String	The external product name (e.g., "2 Yıllık Plan")
brand	String	The product brand
warrantyStartDate	String	Extended warranty start date in yyyy-MM-dd format
warrantyExpireDate	String	Extended warranty expiration date in yyyy-MM-dd format