Logiolegion
blog hero background

26-10-2026

Yakeen and Maroof API Integration in Saudi Arabia: Customer and Business Verification for KSA Apps (2026)

Yakeen and Maroof API Integration in Saudi Arabia: Customer and Business Verification for KSA Apps (2026)

Quick answer: is there a "Maroof Yakeen API"? Not as one service. Yakeen is Elm's service for verifying an individual's identity data against official records, which is the KYC side of onboarding. Maroof was the Ministry of Commerce's trust registry for online stores, and since March 2023 new e-store registration has moved to the Business Platform (business.sa). For checking a business programmatically, the usual route is the Wathq commercial registration API, which covers the KYB side.

  • Verify a person (KYC): Yakeen, through an approved agreement with Elm and with the person's consent
  • Verify a company (KYB): Wathq commercial registration data, looked up by CR number
  • Verify an online store: the Business Platform certificate, stored and checked as part of merchant onboarding

Building onboarding for a Saudi marketplace, fintech or B2B platform? Get an integration access review from Logiolegion →

Most teams searching for "Maroof Yakeen API integration" are building the same thing: an onboarding flow that has to prove who a customer is and whether a merchant or supplier is a real, registered Saudi business. The confusion is understandable, because the two checks are usually bought together but come from different sources. This guide separates them, explains what access each one needs, and shows how to design one onboarding flow around both.

Logiolegion, a GCC-specialist custom software development company with a Dubai delivery presence, builds Saudi onboarding and verification flows for marketplaces, fintech apps, real estate platforms and B2B procurement systems.


Yakeen, Maroof, Wathq, Nafath and Absher: which one does what

These names come up together in Saudi projects, but each one answers a different question. Getting the split right before development is what keeps an onboarding project from being rebuilt later.

ServiceQuestion it answersWho you verifyTypical use in an app
Yakeen (Elm)Does this identity data match official records?IndividualsKYC at sign-up, loan or rental applications, driver onboarding
WathqIs this commercial registration real and active, and who owns it?CompaniesMerchant, supplier and B2B customer onboarding (KYB)
Maroof / Business PlatformIs this online store registered and authenticated?E-storesMarketplace seller onboarding, trust badges
NafathIs the person logging in really the ID holder?IndividualsStrong login and transaction approval
Absher / Absher BusinessGovernment services for individuals and establishmentsIndividuals, employersResidency and workforce workflows

This page covers the first three. For login and approval flows with Nafath, and for Absher Business and Muqeem workflows, see our Absher integration guide for Saudi apps.


What Yakeen verifies, and how access works

Yakeen is an identity verification service run by Elm that lets an approved organisation check a person's identity and personal data against official records. The Saudi Central Bank rulebook describes it as an electronic option for banks to verify customer identity without a branch visit, with the customer's prior approval and no extra fee to the customer (SAMA rulebook: Yakeen for ID verification).

Outside banking, Yakeen is used by lenders, rental and real estate platforms, telecom and other regulated onboarding journeys. Access is commercial and scoped: an organisation agrees which data scopes it may query with Elm, and only those fields come back.

What you need before writing code

  • A signed service agreement with Elm, or access through an approved provider
  • Approved data scopes that match your purpose, not "everything available"
  • A consent step in your flow that the user completes before the lookup
  • Test credentials and documentation for the subscribed service
  • A PDPL record of why each field is processed and how long it is kept

What this means in plain terms

Yakeen is not a free public lookup you can call from a sign-up form. It is a paid, permissioned check, so the business case and the agreement come first, and the developer builds the flow around the scopes you were actually granted.


What happened to Maroof

Maroof was the Ministry of Commerce platform that let online stores register and display a trust badge. On 29 March 2023 the Ministry asked e-store owners to register through the Business Platform run by the Saudi Business Center instead, and described it as the one place for verifying and registering online stores in the Kingdom (Ministry of Commerce announcement).

Older storefronts may still show a Maroof badge, but new registrations go through business.sa. Registration requires a commercial registration or valid freelance or professional certificate, plus a business bank account.

Is there a Maroof API?

We have not found a published public developer API for Maroof or for Business Platform store authentication. Confirm the current position with the Saudi Business Center before you scope, because this can change.

In practice, marketplaces handle store verification by asking sellers to upload their Business Platform certificate, then checking the underlying commercial registration through Wathq. The certificate becomes a document in the seller file with an expiry date and a review status.


Wathq: the practical route to business verification

Wathq is the Ministry of Commerce-linked platform that gives access to commercial registration data through APIs. When it launched, the Ministry described it as giving private sector organisations C.R. data such as trade name, status and date, activities, address and capital, looked up by C.R. number (Ministry of Commerce on Wathq).

Today the developer portal at developer.wathq.sa offers commercial registration lookups, including basic and full CR details, owners and related registrations, alongside other data services. Each product has its own subscription and terms, so check what your plan includes.

What a KYB check usually confirms

  • The CR exists and its status is active, not suspended or expired
  • The legal name matches what the merchant typed in
  • The registered activities fit what they will sell or supply on your platform
  • The owner or manager matches the person completing onboarding
  • The registration's city and address match the seller profile

That combination catches most bad sign-ups: expired CRs, borrowed CR numbers, and businesses selling outside their licensed activity.


One onboarding flow, three checks

Most Saudi platforms need individual and business checks in the same journey, for example a seller who is both a person and a registered store. The design below is illustrative, not an official Elm or Wathq specification.

StepInternal route (illustrative)What happens
1. ConsentPOST /onboarding/{id}/consentUser accepts the identity and business data check, and the consent text and version are logged
2. Person checkPOST /verify/identityBackend calls the approved Yakeen service and stores the result and reference only
3. Business checkPOST /verify/cr/{crNumber}Backend queries Wathq and compares legal name, status, activities and owner
4. Store certificatePOST /onboarding/{id}/documentsSeller uploads the Business Platform certificate for review
5. DecisionGET /onboarding/{id}/statusAuto-approve on a full match, route partial matches to manual review

These are your application's own routes. They do not imply that Elm, Wathq or the Business Platform expose matching endpoints.

Controls that matter in production

  • All Yakeen and Wathq calls run server-side, and credentials never reach a browser or mobile app
  • Store the verification result, reference and timestamp, not full copies of government records
  • Re-check CR status on a schedule, because a CR that was active at onboarding can lapse
  • Treat a timeout as "pending", never as "verified"
  • Log who approved every manual override

PDPL and data handling

Identity numbers, dates of birth and ownership details are personal data under Saudi Arabia's Personal Data Protection Law. You need a defined purpose for each field, an appropriate lawful basis, clear notice to the user, and retention limits (SDAIA PDPL resources).

The simplest safe design keeps the verification outcome and reference, not the raw response, and restricts who can view verification details. Data minimisation also limits what leaks if an admin account is ever compromised.


Who needs this most

Marketplaces and e-commerce platforms need store and CR checks for every seller, and usually Yakeen for the individual behind the account. If you run on Salla, our Salla API integration guide covers the store side.

Fintech, BNPL and lending apps need Yakeen-level identity checks and, for business accounts, Wathq checks on the company and its owners.

Real estate and rental platforms verify tenants, landlords and brokerages before contracts. Contract registration itself is a separate integration, covered in our Ejar API integration guide.

B2B procurement and HR platforms verify suppliers by CR before payment. Workforce data such as Qiwa contracts is a separate integration, covered in our Qiwa API integration guide.


Timeline and cost

The build itself is usually the smaller part of the timeline. Agreements, scopes and test credentials from Elm and Wathq often take longer than the code, so start those first.

Logiolegion scopes verification projects after a short access review: which checks you need, which agreements you already hold, and how many systems the result must reach. You then get a fixed-scope quote in SAR, with third-party subscription fees listed separately from development.


Need customer and merchant verification that holds up?

Tell us what you verify today, which agreements you already have, and where the result needs to go. Logiolegion will map the access you need and send a fixed-scope proposal within 5 business days.

Book a verification integration review →


Frequently Asked Questions

1. What is the Yakeen API? Yakeen is an identity verification service run by Elm that lets approved organisations check a person's identity data against official records. Access is commercial and limited to agreed data scopes, and the person's consent is collected before the lookup. Banks use it as an electronic alternative to in-branch identity checks.

2. Is Maroof still active in Saudi Arabia? Since 29 March 2023, the Ministry of Commerce has directed e-store owners to register through the Business Platform at business.sa instead of Maroof. Some older storefronts still show a Maroof badge, but new registrations and renewals go through the Business Platform.

3. Does Maroof or the Business Platform have a public API? We have not found a published public developer API for Maroof or Business Platform store authentication. Marketplaces usually collect the seller's Business Platform certificate as a document and verify the underlying commercial registration through Wathq. Confirm the current position with the Saudi Business Center before scoping.

4. What is the difference between Yakeen and Nafath? Yakeen checks that identity data matches official records, which suits sign-up and KYC. Nafath confirms that the person logging in or approving an action is the real ID holder, which suits login and transaction approval. Many apps use both at different steps; our Absher and Nafath guide covers the Nafath side.

5. I run a marketplace in Riyadh and need to verify sellers. Can Logiolegion build that? Yes. Logiolegion builds seller onboarding that checks the commercial registration through Wathq, compares legal name, status, activities and owner automatically, and collects the Business Platform certificate for review. Partial matches go to a manual review queue with every approval logged. The same flow can add a Yakeen check on the individual behind the seller account.

6. Can Logiolegion integrate Yakeen into our fintech app's KYC flow? Yes, once you hold an agreement with Elm or access through an approved provider. Logiolegion builds the consent step, the server-side Yakeen call, result storage that keeps the reference rather than raw records, and clear pending, verified and failed states. Timeouts are treated as pending, never as verified.

7. We already have a Yakeen agreement. How fast can Logiolegion connect it? With credentials and documentation in hand, the integration is usually the shorter part of the project, because the work is the consent step, the server-side call, and status handling inside your existing onboarding. Logiolegion starts with a short access review of your scopes and test environment, then gives a fixed-scope quote in SAR.

8. How does Logiolegion keep verification data PDPL-compliant? Logiolegion stores the verification outcome, reference and timestamp instead of full government records, restricts verification details by role, and logs every view and manual override. Each processed field is mapped to a stated purpose and retention period, which gives your compliance team a clear record for PDPL reviews.

9. Can one onboarding flow verify both the person and their company? Yes. Logiolegion designs a single flow where the user consents once, the individual is checked through Yakeen, the company through Wathq, and the store certificate is collected, with one combined decision at the end. Each external service keeps its own credentials, scopes and failure states, so one outage does not block the whole record.

10. Who builds Yakeen and Wathq integrations for Saudi platforms? Logiolegion, a GCC-specialist custom software development company with a Dubai delivery presence, builds Yakeen, Wathq and Business Platform verification into Saudi marketplaces, fintech, real estate and B2B platforms. Projects start with an access review and a fixed-scope SAR quote. Contact Logiolegion to scope your onboarding flow.

Have An Idea That Needs To
Go Mobile? Launch It With Us!

Have an idea that needs to go mobile? Launch it with us!

Share

Continue Reading

Discover our full range of services - from custom software development to complete marketing solutions

footer-background-image

Your Vision, Our Logic — Let's Build The Future Together.

At Logiolegion, we don't just build software — we engineer logical, future-ready solutions for your goals. Let's create something remarkable, together.

Let's Talk Business
LogioLegion logo

Logiolegion ©0 All rights reserved

contact@logiolegion.com

+91 8590143573

Forging Logical Solutions