GREMDocs

Objects (read)

Last updated: 2026-07-242 min read

Read the public catalog of listings — property, rental, and complex (development). Responses use an explicit, stable read-contract (an allowlist), so internal fields never leak and new model fields never appear by surprise. Reads are GET, and they are free (not counted against your API-call quota).

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

List

GET /objects?kind=property&city=Kyiv&page=1&limit=20&sort=newest
Authorization: Bearer gsk_live_...

Query parameters:

  • kind (required) — property, rental, or complex
  • city, country (optional) — exact match filters
  • page (default 1), limit (default 20, max 50)
  • sort — newest (default) or oldest

Response:

{
  "data": [ { "id": "...", "kind": "property", "name": "...", "price": 120000, "currency": "USD", ... } ],
  "paginate": { "currentPage": 1, "totalPages": 471, "totalCount": 9412 },
  "requestId": "req_..."
}

Get one

GET /objects/{kind}/{id}
Authorization: Bearer gsk_live_...

{kind} is property, rental, or complex. Returns a single object in the same shape, plus a requestId. Unknown id returns 404.

The object shape

Common fields (exact set varies by kind):

  • id, kind, name, slug, status (active or sold), createdAt
  • price, currency (property/rental); price: { from, to, currency } (complex)
  • address — full address, including street and location coordinates
  • constructionYear — a plain 4-digit year (null if unknown)
  • Areas are objects: spaceAll: { "value": 50, "unit": "m2" }; the display hint is nativeAreaUnit
  • photos — [{ id, isMain, mimetype, variants, ready }]
  • author — the listing agent/agency (curated public block)
  • Complex adds apartmentPlans[] (unit layouts) and progress[] (construction progress)

Category and attribute fields (type, condition, utilitySystem, apartType, amenities, status, ...) are returned as codes. Decode them with the dictionaries endpoint.

Each photo has a ready flag. It is false while the watermarked renditions are still being generated. Poll again (or render a placeholder) until ready is true rather than caching an unfinished image.

What you see

The response is scoped to who you are:

  • Any object — the public listing card (what visitors see on grem.capital).
  • A listing under an open commission — as an authenticated broker you additionally see the reward on an approved agreement, so you can decide whether to send a lead.
  • Your own objects — your full owner view.

Never exposed to anyone: owner private contacts, imported seller data, moderation notes, un-watermarked photo originals, and internal identifiers.

Was this article helpful?