Skip to main content

​
Before You Start

In order to use Agd Ejar’s APIs, make sure you already have:
  • Commercial registration (CR) issued by ministry of commerce (CR).
  • Your CR included activity code 682010 (Real Estate Brokerage). read more
  • FAL lisance from REGA. read more
  • An active account in Ejar.sa.
  • An active account with us at Agd Ejar 😊

​
Enabling ECRS

To create an account with Agd Ejar, first you need to enable “External Contract Registration Service” (ECRS) for your Ejar’s account, to do so please contact us at [email protected] with the following information:
  • Admin’s ID number (must be a Saudi & has Nafath access)
  • Saudi Commercial Registration (PDF)
  • Saudi Mobile Number
  • Email Then we will send your information to Ejar to to request enabling ECRS for your account.
It might takes ~ 3 - 7 business days to enable ECRS for your account by Ejar’s team.

​
ECRS credentials

Once ECRS is enabled, login into your Ejar account then click on your name in the top right corner and select “Manage Office” Manage Office From the left sidebar, select “External Registration” then click on “Create” Create External Registration
If you didn’t see the “External Registration” option, that’s mean ECRS is not enabled for your account yet, please contact us at [email protected]

​
Integration Steps

Follow these steps to quickly integrate with Agd Ejar API.

​
1. Get Your Credentials

  1. Contact our support team at [email protected]
  2. Provide your organization details
  3. Receive your client_id and client_secret
Once you have your credentials, test the authentication:
curl --request POST \
  --url 'https://app.agdejar.sa/oauth/token' \
  --header 'Content-Type: multipart/form-data' \
  --form 'grant_type=client_credentials' \
  --form 'client_id=your_client_id' \
  --form 'client_secret=your_client_secret' \
  --form 'scope=read'

​
2. Explore the API

  1. Access our Postman Collection
  2. Import the collection into your Postman
  3. Set up your environment variables
  4. Test different endpoints
Check our code examples in multiple languages:
# List Properties Example
curl --request GET \
  --url 'https://app.agdejar.sa/tenant/v1/properties' \
  --header 'Accept: application/json' \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

​
Essential Integrations

Start with these core features to get your integration running.

Property Management

Learn how to manage properties and units

Contract Operations

Start creating and managing contracts

Party Management

Handle tenant and owner information

Authentication

Set up secure API authentication

​
Best Practices

Follow these guidelines for successful integration:

Error Handling

Implement proper error handling and retries

Rate Limiting

Understand and respect API rate limits

Status Monitoring

Monitor API status and uptime

Support

Get help when you need it

​
Next Steps

Review our detailed API Reference for comprehensive endpoint documentation.
Check our FAQ and Troubleshooting Guide for solutions to common problems.
Keep an eye on our Status Page for real-time API status updates.