Maalam Developers
Integration

List and search units

Paged. `q` matches the unit code or type; `status` and `project` (a slug) narrow the list.

GET
/v1/integration/units

Paged. q matches the unit code or type; status and project (a slug) narrow the list.

AuthorizationBearer <token>

An API key from the back office (settings → API), sent as Authorization: Bearer mlm_live_….

In: header

Query Parameters

page?integer
Range1 <= value <= 9007199254740991
Default1
pageSize?integer
Range1 <= value <= 100
Default25
q?string
Lengthlength <= 100
status?string

Value in

  • "available"
  • "held"
  • "reserved"
  • "sold"
  • "unavailable"
project?string
Match^[a-z0-9]+(-[a-z0-9]+)*$
Length2 <= length <= 100

Response Body

application/json

curl -X GET "https://example.com/v1/integration/units"
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "projectId": "5a8591dd-4039-49df-9202-96385ba3eff8",      "code": "string",      "type": "string",      "areaSqm": 1,      "priceSar": 1,      "vatIncluded": true,      "vatRate": 0,      "depositPercent": 0,      "status": "available",      "bedrooms": 0,      "bathrooms": 0,      "deliveryYear": 2000,      "description": "string",      "images": [],      "files": [],      "holdExpiresAt": "2019-08-24T14:15:22Z",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z",      "projectName": "string",      "projectSlug": "string",      "ref": "string"    }  ],  "page": 1,  "pageSize": 1,  "total": 0}