Harmony IntegrationHarmony Integration

Available Devices

POST /api/insurance/SearchItem

📱 Search for devices that match specific criteria and are available for insurance.

  • 🔍 Filter by category, manufacturer, or search term
  • 📋 Returns a list of devices with their itemNo codes and retail prices — use these in SearchTemplates and CreateContract

About itemCategoryCode

The dropdown above shows a placeholder list that may not be complete. Categories available for your account can differ — sign in to load them automatically, or call SearchItemCategory to fetch the real list for your account.

POST
/api/insurance/SearchItem

Authorization

BearerAuth
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

itemCategoryCode*stringPHONETABLETNOTEBOOKVISUALWEARABLESOTHERDESKTOPNote: this is a placeholder list and may not be complete. The categories available for your account can differ — sign in to load them automatically, or call SearchItemCategory to fetch the complete list.
Device category code (required).
manufacturerCode?string
Manufacturer code to filter results. Leave empty to include all manufacturers.
searchTerm?string
Search term to filter devices by name. Leave empty to return all devices for the selected category.
exactMatch?boolean
If true, only exact matches for the search term are returned. If false, partial matches are included.

Response Body

application/json

curl -X POST "https://jubilee-ws.test.harmony.nl/api/insurance/SearchItem" \  -H "Content-Type: application/json" \  -d '{    "itemCategoryCode": "OTHER",    "manufacturerCode": "",    "searchTerm": "",    "exactMatch": false  }'
{
  "success": true,
  "errors": null,
  "items": [
    {
      "code": "OTHER-ACER",
      "description": "Other Acer",
      "amount": 0,
      "itemCategoryCode": "OTHER",
      "manufacturerCode": "ACER"
    },
    {
      "code": "OTHER-APPLE",
      "description": "Other Apple",
      "amount": 0,
      "itemCategoryCode": "OTHER",
      "manufacturerCode": "APPLE"
    }
  ]
}