Dictionaries

In listing responses, category and attribute fields come as codes (for example type: "Residential", condition: "Cosmetic renovation", utilitySystem: ["gas", "water"]). This endpoint turns codes into human labels in any of 10 supported languages. Free and open to any key.

Base URL: https://developers.grem.capital/api/v1.

Labels for one language

GET /dictionaries?lang=en
Authorization: Bearer gsk_live_...

Returns every dictionary flattened to { code: label } for that language:

{
  "version": "sha256-...",
  "lang": "en",
  "dictionaries": {
    "propertyType": { "Residential": "Residential", "Commercial": "Commercial", ... },
    "condition": { ... },
    "utilitySystem": { ... },
    ...
  },
  "requestId": "req_..."
}

Supported lang: en, ru, uk, de, es, az, ar, fr, zh, tr. Anything else - 400. When a code has no label in the requested language, the English one is returned.

Variants

• All languages at once - omit lang. Each code comes with a labels object: { "value": "Residential", "labels": { "en": "Residential", "uk": "Житлова", ... } }.
• One dictionary - add name, e.g. GET /dictionaries?name=propertyType&lang=en. Unknown name - 404.

Available dictionaries

propertyType, residentialType, commercialType, industrialType, condition, utilitySystem, amenities, onsiteAmenities, apartType, apartmentType, status, objectType.