Maalam Developers

Search

Listing and filtering the units you have pushed.

GET /v1/integration/units?q=A-1&status=available&project=alasala&page=1&pageSize=50
ParameterMeaning
qMatches the unit code or type, case-insensitively, anywhere in the string
statusOne of available, unavailable, held, reserved, sold
projectA project slug
page1-based; default 1
pageSizeDefault 25, at most 100

The response is a page:

{
  "items": [ … ],
  "page": 1,
  "pageSize": 50,
  "total": 138
}

Items are ordered by project name, then unit code. A project that does not exist is a 404, not an empty page — so a typo in a slug is not mistaken for an empty project.

Reading one unit

GET /v1/integration/projects/alasala/units/A-101

Returns the unit with its current status, holdExpiresAt when a buyer is sitting on it, and the images and files Maalam has for it — whichever of those came through this API and whichever were uploaded in the back office.

Reading projects

GET /v1/integration/projects
GET /v1/integration/projects/alasala

The list is not paged; a developer has a handful of projects. Each carries a unitCount.

On this page