Developer Resources

AssetsMena API Documentation

Comprehensive API documentation for integrating with AssetsMena's AI-powered CRM platform. Build custom solutions and automate your real estate workflows.

Quick Start

Authentication

curl -X POST https://api.assetsmena.com/api/auth/login \ -H "Content-Type: application/json" \ -d '{"email": "[email protected]", "password": "your-password"}'

All API requests require an access token obtained through the login endpoint. Include the token in the Authorization header as a Bearer token.

Base URL

https://api.assetsmena.com/api

All API endpoints are relative to the base URL. Include your tenant ID in query parameters or headers for multi-tenant isolation.

Authentication

Secure authentication and authorization for API access

POST/api/auth/loginAuthenticate user and get access token
POST/api/auth/registerRegister new user account
POST/api/auth/refreshRefresh access token
POST/api/auth/logoutInvalidate access token

Properties & Inventory

Manage real estate inventory and property listings

GET/api/propertiesGet all properties for tenant
GET/api/properties/{id}Get specific property details
POST/api/propertiesCreate new property
PUT/api/properties/{id}Update property information
GET/api/projectsGet all projects
GET/api/projects/{id}Get project details

Leads & CRM

AI-powered lead management and customer relationship tools

GET/api/leadsGet all leads with AI scoring
GET/api/leads/{id}Get specific lead details
POST/api/leadsCreate new lead
PUT/api/leads/{id}Update lead information
GET/api/opportunitiesGet sales opportunities
POST/api/leads/{id}/scoreGet AI-powered lead score

Broker Network

Broker management and commission tracking

GET/api/brokersGet all brokers
GET/api/brokers/{id}Get broker details
POST/api/brokersAdd new broker
GET/api/broker-networkGet broker network data
POST/api/broker-network/assignAssign lead to broker
GET/api/commissionsGet commission data

Payments & Finance

Payment processing and financial management

GET/api/paymentsGet all payments
POST/api/paymentsRecord new payment
GET/api/payment-schedulesGet payment schedules
POST/api/payments/initiateInitiate payment via Paymob
GET/api/finance/reportsGet financial reports

AI Features

AI-powered analytics and automation tools

GET/api/ai/analyticsGet AI-powered analytics
POST/api/ai/recommendationsGet AI recommendations
GET/api/ai/predictionsGet predictive insights
POST/api/ai/automationTrigger AI automation
GET/api/ai/insightsGet business insights

Code Examples

JavaScript/Node.js

// Authenticate and get leads
const response = await fetch('https://api.assetsmena.com/api/auth/login', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    email: '[email protected]',
    password: 'password'
  })
});

const { accessToken } = await response.json();

// Get leads with AI scoring
const leadsResponse = await fetch('https://api.assetsmena.com/api/leads?tenantId=1', {
  headers: {
    'Authorization': 'Bearer ' + accessToken,
    'Content-Type': 'application/json',
  }
});

const leads = await leadsResponse.json();
console.log('Leads with AI scores:', leads);

Python

import requests

# Authenticate
response = requests.post(
    'https://api.assetsmena.com/api/auth/login',
    json={
        'email': '[email protected]',
        'password': 'password'
    }
)

token = response.json()['accessToken']

# Get properties
headers = {
    'Authorization': 'Bearer ' + token,
    'Content-Type': 'application/json'
}

properties = requests.get(
    'https://api.assetsmena.com/api/properties?tenantId=1',
    headers=headers
).json()

print('Properties:', properties)

Rate Limits & Security

Rate Limits

  • • Standard tier: 1000 requests/hour
  • • Premium tier: 5000 requests/hour
  • • Enterprise tier: Custom limits

Security

  • • JWT-based authentication
  • • HTTPS required for all requests
  • • Tenant isolation enforced
  • • Rate limiting per API key

SDKs & Libraries

Official SDKs

  • • JavaScript/TypeScript SDK
  • • Python SDK
  • • PHP SDK
  • • .NET SDK

Community Libraries

  • • React hooks library
  • • Vue.js components
  • • Angular services
  • • Mobile SDKs

Ready to Build with AssetsMena?

Start integrating with our AI-powered CRM platform. Get your API keys and begin building custom solutions for your real estate business.