Get a project's unit availability over time (GET /projects/{id}/availability) — Kite API
Skip to content
KitePlatform
Pricing
Browse endpoints
All endpoints

Reference data

  • List cities
  • List neighborhoods
  • List city directions
  • List enumerated values
  • Get this key's limits
  • What the API covers

Listings

  • Search listings
  • Count listings
  • Get listings by id
  • Get a listing
  • Get a listing's price history
  • Get a listing's advertiser contact

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood
  • Commercial rent per m² by neighborhood
  • Plots for sale against their last registered sale
  • Registered sale price against the asking price
  • Places, population and landmarks around a point or in a neighborhood

Official data

  • Registered rents (REGA)
  • Kite Property Index

Analytics

  • Get comparable listings
  • Get a listing's market position
  • Get a listing's nearby asking-price band
  • Find below-market listings
  • Find below-market listings (old path)
  • Get gross rental yield
  • Get price trends
  • Compare neighborhoods
  • List advertisers by matching listings
  • Check the asking price for any home

Registered transactions

  • Search registered deals
  • Registered deal statistics
  • Land prices per m²

Off-plan projects

  • Search projects
  • Get a project
  • List a project's units
  • Get a project's unit availability over time
  • Search project units
  • List developers
  • Get a project's absorption by month
  • Project absorption by area, developer or type

Exports

  • Create an export
  • List exports
  • Get an export

Administration

  • Get your organization
  • List data keys
  • Create a data key
  • Revoke a key
  • List projects
  • Daily usage
  • List members and invitations
  • List audit events
  • List request logs
  • Create a webhook endpoint
  • List webhook endpoints
  • Update a webhook endpoint
  • Re-enable a webhook endpoint
  • Rotate a webhook signing secret
  • Delete a webhook endpoint
  • List deliveries
  • Replay a delivery

Interactive reference

All endpoints

Reference data

  • List cities
  • List neighborhoods
  • List city directions
  • List enumerated values
  • Get this key's limits
  • What the API covers

Listings

  • Search listings
  • Count listings
  • Get listings by id
  • Get a listing
  • Get a listing's price history
  • Get a listing's advertiser contact

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood
  • Commercial rent per m² by neighborhood
  • Plots for sale against their last registered sale
  • Registered sale price against the asking price
  • Places, population and landmarks around a point or in a neighborhood

Official data

  • Registered rents (REGA)
  • Kite Property Index

Analytics

  • Get comparable listings
  • Get a listing's market position
  • Get a listing's nearby asking-price band
  • Find below-market listings
  • Find below-market listings (old path)
  • Get gross rental yield
  • Get price trends
  • Compare neighborhoods
  • List advertisers by matching listings
  • Check the asking price for any home

Registered transactions

  • Search registered deals
  • Registered deal statistics
  • Land prices per m²

Off-plan projects

  • Search projects
  • Get a project
  • List a project's units
  • Get a project's unit availability over time
  • Search project units
  • List developers
  • Get a project's absorption by month
  • Project absorption by area, developer or type

Exports

  • Create an export
  • List exports
  • Get an export

Administration

  • Get your organization
  • List data keys
  • Create a data key
  • Revoke a key
  • List projects
  • Daily usage
  • List members and invitations
  • List audit events
  • List request logs
  • Create a webhook endpoint
  • List webhook endpoints
  • Update a webhook endpoint
  • Re-enable a webhook endpoint
  • Rotate a webhook signing secret
  • Delete a webhook endpoint
  • List deliveries
  • Replay a delivery

Interactive reference

Off-plan projects

Get a project's unit availability over time

GET/projects/{id}/availability

Daily snapshots of a project's unit count and the availability its source reports, as daily, weekly or monthly points, each with the units absorbed since the previous point.

This is listed availability, not contracts: it comes from what the project's source page showed on the day, so a unit counts as absorbed when the source stops showing it, not when it is sold or leased. Kite began keeping snapshots on 2026-09-26 (earlier dates have none); coverage gives the range held for this project. Only some sources report available units; where they don't, available_units and absorbed_since_previous are null and total_units is the project's unit count. unit_type narrows total_units and unit_types to one type for sources that send counts per type. Defaults to the last 90 days, up to 366. Returns 404 for inactive projects.

Authentication
Send a data key (dk_live_… or dk_test_…) as a Bearer token.
Scope
projects
Cost
10 units per call

Parameters

NameDescription
idrequiredType: integer · path

Project id.

intervalType: string · query

Point spacing; each point is the last snapshot in its day, week or month.

One of: daily, weekly, monthly

fromType: string · query

First day (YYYY-MM-DD, Riyadh time). Defaults to 90 days before to.

toType: string · query

Last day (YYYY-MM-DD). Defaults to today.

unit_typeType: string · query

Unit type as the source names it (for example apartment, villa); see unit_types in the response.

Response

The data field is an object with these fields.

NameDescription
project_idrequiredType: integer
intervalrequiredType: string

One of: daily, weekly, monthly

fromrequiredType: string

First day of the range, YYYY-MM-DD.

torequiredType: string

Last day of the range, YYYY-MM-DD.

unit_typerequiredType: string | null
coveragerequiredType: object
pointsrequiredType: object[]

Example request

cURL
curl "https://api.kite.sa/v1/projects/4812/availability" \  -H "Authorization: Bearer $KITE_API_KEY"
JavaScript (@kite-sa/sdk)
import { Kite } from "@kite-sa/sdk";const kite = new Kite(); // reads KITE_API_KEYconst result = await kite.projects.availability(4812);
Python (kite-sa)
from kite_sa import Kitekite = Kite()  # reads KITE_API_KEYresult = kite.projects.availability(4812)

Open in the interactive reference

Related endpoints

  • Search projectsGET /projects
  • Get a projectGET /projects/{id}
  • List a project's unitsGET /projects/{id}/units
  • Search project unitsGET /project-units
  • List developersGET /developers
  • Get a project's absorption by monthGET /projects/{id}/absorption
  • Project absorption by area, developer or typeGET /market/absorption

Guides

  • Quickstart
  • Searching and filtering
  • Limits and quotas
  • Pagination
  • Errors

Ready to make a request? The Sandbox plan is free. For volume or licensing, talk to us.

Get an API keyTalk to us
Kite API

Saudi real estate data for developers.

Product
  • Data coverage
  • Pricing
  • Investors and developers
  • Valuation checks
  • Proptech and apps
Developers
  • Quickstart
  • Guides
  • API reference
  • MCP server
  • JavaScript SDK (npm)
  • Python SDK (PyPI)
  • Changelog
  • Status
Company
  • kite.sa
  • Blog
  • Contact
  • Security
Legal
  • Terms
  • Sources and data rights
  • Privacy
  • DPA
  • Subprocessors
© Kite