Dictionaries

Object responses return category and attribute fields as codes (for example type: "Residential", condition: "Cosmetic renovation", utilitySystem: ["gas", "water"]). Use this endpoint to turn those codes into human-readable labels, in any of the 8 supported locales.

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

Get labels for a locale

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

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

{
  "version": "2026-07-24",
  "lang": "en",
  "dictionaries": {
    "propertyType": { "Residential": "Residential", "Commercial": "Commercial", ... },
    "condition": { "Cosmetic renovation": "Cosmetic renovation", ... },
    "utilitySystem": { ... },
    ...
  },
  "requestId": "req_..."
}

Supported lang: en, ru, uk, de, es, az, ar, fr.

Variations

• All locales at once — omit lang. Each code returns a full labels object: { "value": "Residential", "labels": { "en": "Residential", "ru": "Жилая", ... } }.
• A single dictionary — add name, e.g. GET /dictionaries?name=propertyType&lang=en. An unknown name returns 404.

Available dictionaries

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