How to use Business Verification

Lean’s Business Verification API enables you to verify a business exists and is registered, along with returning the necessary data points needed to meet your KYB requirements, supporting compliance with SAMA’s due-diligence standards.

We verify a business legitimacy using authoritative data sources, our API is designed to support:

Business onboarding and account opening
KYB (Know Your Business) compliance
Ownership and control verification
Risk and fraud assessment

The API returns structured verification results that can be consumed directly in automated flows or reviewed manually by compliance teams.

We offer two verification types, Full (returning all commercial registration data) and Basic (returning a subset of this data). For both Full and Basic checks you will need the Unified National Number (UNN) to make the request on the API;

Feature Group	Full	Basic
Company Registration	✓	✓
Business Details	✓	✓
Nature of Business	✓	✓
Branches	✓	—
Relationships	✓	—
Managers	✓	—
Ownership & Partners	✓	—
Capital Structure	✓	—
E-Commerce Presence	✓	—
Licensing Information	✓	—
Fiscal Year Structure	✓	—
Company Status History	✓	—
Contact Information	✓	—
Liquidators	✓	—

Example response for Full Verification

Requested with Unified National Number (UNN) and request type set to ‘Full’

{
  "status": "OK",
  "results_id": "0f79abdf-fa89-93a3-8b9c-40a3b6dc2b3a",
  "message": "Data successfully retrieved",
  "timestamp": "2024-10-24T15:37:35.254Z",
  "meta": null,
  "status_detail": null,
  "verifications": {
    "commercial_registry": {
      "national_number": "7001272184",
      "registration_number": "1010711252",
      "version_number": 1
    },
    "company_name": {
      "ar": "شركة اختبار للتجارة",
      "en": null
    },
    "name_language": {
      "id": 1,
      "description": {
        "ar": "العربية",
        "en": null
      }
    },
    "commercial_registration_capital": 150000,
    "days_since_company_established": 99,
    "main_commercial_registry": {
      "is_main": false,
      "national_number": null,
      "registration_number": null
    },
    "issue_date": {
      "gregorian": "2002-10-05",
      "hijri": "1423-07-28"
    },
    "in_liquidation_process": false,
    "has_ecommerce": true,
    "headquarters": {
      "city_id": 1,
      "city_name": {
        "ar": "الرياض",
        "en": null
      }
    },
    "license": {
      "is_license_based": false,
      "issuer_national_number": "123456789",
      "issuer_name": {
        "ar": "xx",
        "en": null
      }
    },
    "partners": {
      "nationality": {
        "ar": "السعودية",
        "en": null
      }
    },
    "entity_type": {
      "name": {
        "ar": "شركة ذات مسؤولية محدودة",
        "en": null
      },
      "form_name": {
        "ar": "ذات مسؤولية محدودة",
        "en": null
      },
      "characters": [
        {
          "ar": "غير ربحية خاصة",
          "en": null
        }
      ]
    },
    "status": {
      "ar": "فعال",
      "en": null
    },
    "confirmation_date": {
      "gregorian": "2003-10-05",
      "hijri": "1424-07-28"
    },
    "reactivation_date": {
      "gregorian": "2023-03-10",
      "hijri": "1444-08-18"
    },
    "suspension_date": {
      "gregorian": "2022-12-05",
      "hijri": "1444-04-11"
    },
    "deletion_date": {
      "gregorian": "2024-07-20",
      "hijri": "1445-01-13"
    },
    "contact_info": {
      "phone_number": "011256398",
      "mobile_number": "050111101",
      "email": "[email protected]",
      "website_url": "www.google.com"
    },
    "e_commerce": {
      "e_store": [
        {
          "authentication_platform_url": "www.google.com",
          "store_url": "www.google.com",
          "store_activities": [
            {
              "ar": "صناعة زبدة المكسرات",
              "en": null
            }
          ]
        }
      ]
    },
    "capital_information": {
      "currency": {
        "ar": "ريال سعودي",
        "en": null
      },
      "contribution_capital": {
        "type": {
          "ar": "نقدي و عيني",
          "en": null
        },
        "cash_capital": 75000,
        "in_kind_capital": 75000,
        "contribution_value": 100,
        "total_cash_contribution": 750,
        "total_in_kind_contribution": 750
      },
      "stock_capital": {
        "type": {
          "ar": "xx",
          "en": null
        },
        "capital": 12000,
        "announced_capital": 1244,
        "paid_capital": 12333,
        "cash_capital": 1111,
        "in_kind_capital": 111,
        "stocks": [
          {
            "count": 11,
            "value": 12,
            "type": {
              "ar": "xx",
              "en": null
            },
            "class_reference_id": 1,
            "class_name": {
              "ar": "xx",
              "en": null
            }
          }
        ]
      }
    },
    "fiscal_year": {
      "is_first": true,
      "calendar_type": {
        "ar": "ميلادي",
        "en": null
      },
      "end_month": 12,
      "end_day": 30,
      "end_year": null
    },
    "parties": [
      {
        "name": {
          "ar": "السيد عبدالعزيز احمد خالد الثنيان",
          "en": null
        },
        "type": {
          "ar": "جمعية خيرية/ مؤسسة أهلية",
          "en": null
        },
        "identity": {
          "id": "1234567890",
          "type": {
            "ar": "هوية وطنية",
            "en": null
          }
        },
        "partnership": [
          {
            "ar": "عضو",
            "en": null
          }
        ],
        "partner_share": {
          "cash_contribution_count": 250,
          "in_kind_contribution_count": 250,
          "total_contribution_count": 500
        },
        "nationality": null,
        "license_number": null,
        "commercial_registration_number": null
      }
    ],
    "management": {
      "structure_name": {
        "ar": "مجلس مديرين",
        "en": null
      },
      "managers": [
        {
          "name": {
            "ar": "السيد عبدالعزيز احمد خالد الثنيان",
            "en": null
          },
          "type": {
            "ar": "سعودي",
            "en": null
          },
          "is_licensed": true,
          "identity": {
            "id": "1234567890",
            "type": {
              "ar": "هوية وطنية",
              "en": null
            }
          },
          "nationality": {
            "ar": "سعودي",
            "en": null
          },
          "positions": [
            {
              "ar": "عضو",
              "en": null
            }
          ]
        }
      ]
    },
    "liquidators": [
      {
        "name": {
          "ar": "عبدالله سالم هليل الشمري",
          "en": null
        },
        "type": {
          "ar": "فرد سعودي",
          "en": null
        },
        "identity": {
          "id": "2345678901",
          "type": {
            "ar": "هوية وطنية",
            "en": null
          }
        },
        "nationality": {
          "ar": "سعودي",
          "en": null
        },
        "positions": [
          {
            "ar": "عضو",
            "en": null
          }
        ]
      }
    ],
    "activities": [
      {
        "ar": "أنشطة أخرى خاصة بصناعة نشر الأخشاب",
        "en": null
      },
      {
        "ar": "صناعة السلالم والدرابزينات",
        "en": null
      }
    ]
  }
}

Examples response for Basic Verification

Requested with Unified National Number (UNN) and request type set to ‘Basic’

{
  "status": "OK",
  "results_id": "0f79abdf-fa89-93a3-8b9c-40a3b6dc2b3a",
  "message": "Data successfully retrieved",
  "timestamp": "2024-10-24T15:37:35.254Z",
  "meta": null,
  "status_detail": null,
  "verifications": {
    "commercial_registry": {
      "national_number": "7001272475",
      "registration_number": "1010711252",
      "version_number": 1
    },
    "company_name": {
      "ar": "شركة اختبار للتجارة",
      "en": null
    },
    "name_language": {
      "id": 1,
      "description": {
        "ar": "العربية",
        "en": null
      }
    },
    "main_commercial_registry": {
      "is_main": false,
      "national_number": null,
      "registration_number": null
    },
    "issue_date": {
      "gregorian": "2002-10-05",
      "hijri": "1423-07-28"
    },
    "in_liquidation_process": false,
    "has_ecommerce": true,
    "headquarters": {
      "city_id": 1,
      "city_name": {
        "ar": "الرياض",
        "en": null
      }
    },
    "license": {
      "is_license_based": false
    },
    "entity_type": {
      "name": {
        "ar": "شركة ذات مسؤولية محدودة",
        "en": null
      },
      "form_name": {
        "ar": "ذات مسؤولية محدودة",
        "en": null
      },
      "characters": [
        {
          "ar": "غير ربحية خاصة",
          "en": null
        }
      ]
    },
    "status": {
      "ar": "فعال",
      "en": null
    },
    "activities": [
      {
        "ar": "أنشطة أخرى خاصة بصناعة نشر الأخشاب",
        "en": null
      },
      {
        "ar": "صناعة السلالم والدرابزينات",
        "en": null
      }
    ]
  }
}

Testing the API

To test the Business Verification API you can use the below mocked data and responses they will return. You will need to set the verification type in the request to either 'Full' or 'Basic';

Verification Type	Unified National Number
Full	7001272184
Basic	7001272184