Get a project's absorption by month
GET/projects/{id}/absorption
How fast a project's offered units go, per calendar month: units on offer at the start and end, units gone, units re-added and released, the absorption rate (units gone ÷ units at the start), and months of stock left at that pace. Each month carries a reliability and the flags behind it; the project carries history_days and an overall reliability.
This is not a sales record. A portal's or developer site's "available" count is what the page showed on the day. A unit counts as gone when the source stops offering it, which a sale, a reservation, a lease, or the developer pulling it off the page all look like from outside; reservations fall through, and developers hold units back. Read the figures as how fast the advertised offer shrinks, alongside registered deals where you need actual sales.
Which projects. Only sources that publish an inventory count can be measured: unit tables with a status per unit (Asas Makeen, Rasan; basis unit_status), a stated available count (Mada; reported_available), or the number of units listed on the project's page (Wasalt, CompoundIn; listed_units). Every other source's unit count is the project's size, which doesn't move with sales, so most projects have reliability no_inventory_signal. No source reports available units by unit type, so there is no per-type split; listing_type separates sale and rent where the source does. Copies of one project from several sources are read once, from the source with the best basis. Snapshots began on 2026-09-26.
What is left out. Movement that isn't the market is excluded from units_gone and named in each month's flags: readings more than 8 days apart (gap), the whole inventory vanishing at once without being marked sold or reserved (withdrawal), a day on which 40% or more of one source's projects changed (source_change), and, on unit tables, units that leave the table without being marked sold or reserved (units_removed). A project going inactive or a source dropping it ends its series; it is never read as a sell-out. Units appearing are reported as units_released (a new phase) or units_re_added, never netted against units gone.
Returns 404 for inactive projects and for copies merged into another project; GET /projects/{id}/availability has the raw daily snapshots.
- Authentication
- Send a data key (dk_live_… or dk_test_…) as a Bearer token.
- Scope
projects- Cost
- 10 units per call
Parameters
| Name | Description |
|---|---|
idrequiredType: integer · path | Project id. |
listing_typeType: string · query | Which inventory to read: One of: |
fromType: string · query | First month ( |
toType: string · query | Last month ( |
Response
The data field is an object with these fields.
| Name | Description |
|---|---|
project_idrequiredType: integer | |
listing_typerequiredType: string | One of: |
fromrequiredType: string | |
torequiredType: string | |
basisrequiredType: string | null | What the inventory count is: |
basis_sourcerequiredType: string | null | The source the series is read from. |
reliabilityrequiredType: string |
One of: |
history_daysrequiredType: integer | Days from the first to the last reading of the series. |
first_observedrequiredType: string | null | |
last_observedrequiredType: string | null | |
readingsrequiredType: integer | Days with an inventory reading. |
latest_availablerequiredType: integer | null | Units on offer at the last reading. |
usable_monthsrequiredType: integer | |
units_gone_per_monthrequiredType: number | null | Pace over the last (up to) three usable months, units a month. |
months_of_stockrequiredType: number | null |
|
monthsrequiredType: object[] |
Related endpoints
- Search projects
GET /projects - Get a project
GET /projects/{id} - List a project's units
GET /projects/{id}/units - Get a project's unit availability over time
GET /projects/{id}/availability - Search project units
GET /project-units - List developers
GET /developers - Project absorption by area, developer or type
GET /market/absorption