Skip to main content
Developer API

Build on the Sakani Pro Platform

Powerful RESTful APIs for MENA property management. Ejar (Saudi Arabia), Ejari (UAE), multi-country payments (SADAD, Fawry, BenefitPay), tenant operations, and maintenance workflows. The country_code parameter enables seamless integration across all 13 MENA markets.

Explore Endpoints Quick Start

API Overview

Everything you need to integrate with the Sakani Pro platform

RESTful API

JSON-based RESTful API with predictable resource-oriented URLs. Base URL: api.www.sakanipro.com/v1

OAuth 2.0 Auth

Secure authentication with OAuth 2.0 bearer tokens. API keys available via your dashboard. Supports scoped permissions for granular access.

Rate Limits

Professional: 1,000 requests/min. Enterprise: 10,000 requests/min. Rate limit headers included in every response for easy monitoring.

API Endpoints

Comprehensive endpoints for every aspect of property management

Properties

CRUD operations for properties and units across MENA. Filter by country_code (SA, AE, EG, MA...) to scope results. Manage listings, photos, documents, occupancy, and metadata across your multi-country portfolio.

GET /v1/properties
POST /v1/properties
PUT /v1/properties/{id}

Tenants

Manage tenant profiles with country-aware ID verification (Saudi National ID, UAE Emirates ID, Egyptian National ID), communication logs, screening results, and portal access. National ID format validated per country_code.

GET /v1/tenants
POST /v1/tenants
GET /v1/tenants/{id}/leases

Leases

Create and manage leases with country-specific registration. Ejar (SA), Ejari/Tawtheeq (AE), or standard (other countries) — selected automatically via country_code. Contract creation, renewals, terminations, and real-time registration status sync.

POST /v1/leases
POST /v1/leases/{id}/renew
GET /v1/leases/{id}/ejar-status

Payments

Multi-gateway payment processing by country: SADAD (SA), Fawry & InstaPay (EG), BenefitPay (BH), KNET (KW). The currency field is dynamic and set by country_code. Invoicing, receipts, country-specific VAT rates, and financial reconciliation.

POST /v1/payments
GET /v1/payments/{id}/receipt
GET /v1/invoices

Maintenance

Work orders, vendor assignment, preventive scheduling, photo attachments, and real-time status tracking for maintenance operations.

POST /v1/maintenance
PUT /v1/maintenance/{id}
GET /v1/maintenance/{id}/status

Webhooks

Real-time event notifications for payment receipts, lease expirations, maintenance updates, lease registration status changes (Ejar, Ejari, Tawtheeq), and tenant actions. Webhook payloads include country_code and currency fields.

POST /v1/webhooks
GET /v1/webhooks
DEL /v1/webhooks/{id}

Countries

Public

Public endpoint listing all 13 supported MENA countries with their currency codes, VAT rates, supported payment gateways, lease registration systems, and available regulatory compliance modules. No authentication required.

GET /v1/countries
GET /v1/countries/{code}
?fields=currency,vat_rate,payment_gateways

Quick Start Example

Get up and running with a single API call

List Properties with country_code - cURL 
curl -X GET \
  "https://api.www.sakanipro.com/v1/properties" \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Accept-Language: ar"

# Response (200 OK)
{
  "data": [
    {
      "id": "prop_ryd_001",
      "name": "Al Malqa Residence",
      "name_ar": "سكن الملقا",
      "city": "Riyadh",
      "units": 24,
      "occupancy_rate": 0.92,
      "ejar_status": "active",
      "monthly_revenue_sar": 180000
    }
  ],
  "meta": { "total": 47, "page": 1, "per_page": 20 }
}

Official SDKs

Get started quickly with our official libraries

Python

pip install sakanipro

View on GitHub

Node.js

npm install @sakanipro/sdk

View on GitHub

PHP

composer require sakanipro/sdk

View on GitHub

Ready to Start Building?

Get your API keys from the Sakani Pro dashboard. Our developer support team is available to help you integrate successfully. Enterprise customers get dedicated developer liaison.

Get API Keys Developer Support