> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agd.sa/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Your gateway to simplified Ejar.sa integration

<img className="block dark:hidden" src="https://mintcdn.com/agd/tKraNNzPgBqrfDX9/images/hero-light.svg?fit=max&auto=format&n=tKraNNzPgBqrfDX9&q=85&s=e6c273236596e602715e3cccc564fb2d" alt="Hero Light" width="700" height="320" data-path="images/hero-light.svg" />

<img className="hidden dark:block" src="https://mintcdn.com/agd/tKraNNzPgBqrfDX9/images/hero-dark.svg?fit=max&auto=format&n=tKraNNzPgBqrfDX9&q=85&s=e40f731a45508af51526e9ad7fd1a277" alt="Hero Dark" width="700" height="320" data-path="images/hero-dark.svg" />

## Getting Started

If you lucky, you might come across original Ejar's API documentation,you noticed:

* You need a permession to access it from whitelisted IPs.
* Not well written and not easy to understand.
* You need to call multiple endpoints to get the data you need.
* Not all endpoints are available.
* No code examples.

By using our APIs, you will facilitate your integration with Ejar.sa by:

* A single endpoint to get all the data you need.
* Easy to understand documentation.
* No need to worry about whitelisted IPs.
* Code examples in many languages (soon).
* We will keep our API up to date with Ejar's changes.
* You'll get extra integrations with other services out of the box.
* You can focus on building your product and we will take care maintaining the rest.

Our goal is to make it easy for you to integrate with Ejar.sa without the hassle.

## Partners

You are fully integrated with:

* Ejar : National portal for e-contracts
* Saudi Post (SPL) : Validating national address
* Ministry of Justice : Validating deeds & proxies
* Minstery of Commerce : Validating commercial registry
* National Information center (Ministry of Interior) : Validating IDs

All of thiese services are essentals to the contract registration process. By default, you'll be able to use all these services without any extra configuration.

<img className="block" src="https://mintcdn.com/agd/tKraNNzPgBqrfDX9/images/003.png?fit=max&auto=format&n=tKraNNzPgBqrfDX9&q=85&s=74247226d8454ea073c21245681eb2d4" alt="Partners" width="1257" height="138" data-path="images/003.png" />

This chart will give you a quick overview of how it works:

<img className="block" src="https://mintcdn.com/agd/tKraNNzPgBqrfDX9/images/004.png?fit=max&auto=format&n=tKraNNzPgBqrfDX9&q=85&s=9a7a498d48cedf02ef21f3facd18e98a" alt="How it works" width="1999" height="867" data-path="images/004.png" />

<CardGroup cols={2}>
  <Card title="API Documentation" icon="code" href="/api-reference/getting-started">
    Explore our API endpoints and start integrating
  </Card>

  <Card title="Try Our API" icon="rocket" href="https://documenter.getpostman.com/view/39514920/2sAY4yfMHr">
    Test our endpoints using our Postman collection
  </Card>
</CardGroup>

## Essential Resources

Access key tools and information for successful integration.

<CardGroup cols={2}>
  <Card title="Authentication" icon="key" href="/api-reference/auth/oauth-token">
    Learn about our OAuth 2.0 authentication system
  </Card>

  <Card title="API Status" icon="signal" href="https://stats.uptimerobot.com/koyjLJpRaj">
    Check our real-time API status and uptime
  </Card>

  <Card title="Common Issues" icon="wrench" href="/faq/common-issues/troubleshooting">
    Find solutions to common integration challenges
  </Card>

  <Card title="Support" icon="headset" href="mailto:b2b@agd.sa">
    Get help from our technical support team
  </Card>
</CardGroup>

## Key Features

Discover the power of our simplified Ejar integration:

<CardGroup cols={2}>
  <Card title="Property Management" icon="building" href="/api-reference/properties/list-properties">
    Complete property and unit management system
  </Card>

  <Card title="Contract Operations" icon="file-contract" href="/api-reference/contracts/list-contracts">
    Streamlined contract creation and management
  </Card>

  <Card title="Party Management" icon="users" href="/api-reference/parties/search-party">
    Efficient tenant and owner information handling
  </Card>

  <Card title="Latest Updates" icon="clock" href="/changelog/introduction">
    Stay informed about our latest improvements
  </Card>
</CardGroup>

## Implementation Status

Check our current implementation status and upcoming features:

<CardGroup cols={2}>
  <Card title="Authentication" icon="shield-check" href="/api-reference/introduction#authentication-100-ready">
    OAuth token system - 100% Ready
  </Card>

  <Card title="Properties" icon="home" href="/api-reference/introduction#property-management">
    Property management - 98% Ready
  </Card>

  <Card title="Contracts" icon="file-signature" href="/api-reference/introduction#contract-management">
    Contract handling - 90% Ready
  </Card>

  <Card title="View All Status" icon="list-check" href="/api-reference/introduction#todo-list--implementation-status">
    See complete implementation status
  </Card>
</CardGroup>