Lean Technologies Corporate Verification API

The Corporate Verification API from Lean Technologies — 2 operation(s) for corporate verification.

OpenAPI Specification

lean-technologies-corporate-verification-api-openapi.yml Raw ↑
openapi: 3.1.0
info:
  title: Consents Account On File Account Controls (New) Account Controls (New) Corporate Verification API
  version: v0.2.3
servers:
- url: https://sandbox.leantech.me
  description: Sandbox
- url: https://api2.leantech.me
  description: Production
security:
- bearerAuth: []
tags:
- name: Corporate Verification
  x-displayName: Corporate Verification
paths:
  /verifications/v1/corporates:
    servers: []
    post:
      operationId: corporateVerification
      summary: Business Verification
      description: Verify corporate entity information using unified number
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CorporateVerificationRequest'
            examples:
              fullInfo:
                summary: Full information request
                value:
                  type: FULL
                  language: en
                  identifications:
                  - type: UNIFIED_NUMBER
                    value: '7001272184'
              basicInfo:
                summary: Basic information request
                value:
                  type: BASIC
                  language: en
                  identifications:
                  - type: UNIFIED_NUMBER
                    value: '7001272184'
              contractInfo:
                summary: Contract information request
                value:
                  type: CONTRACT
                  language: en
                  identifications:
                  - type: UNIFIED_NUMBER
                    value: '7001272184'
              addressInfo:
                summary: Address information request
                value:
                  type: ADDRESS
                  language: en
                  identifications:
                  - type: UNIFIED_NUMBER
                    value: '7001272184'
              fullInfoArabic:
                summary: Full information request in Arabic
                value:
                  type: FULL
                  language: ar
                  identifications:
                  - type: UNIFIED_NUMBER
                    value: '7001272184'
              basicInfoArabic:
                summary: Basic information request in Arabic
                value:
                  type: BASIC
                  language: ar
                  identifications:
                  - type: UNIFIED_NUMBER
                    value: '7001272184'
              contractInfoArabic:
                summary: Contract information request in Arabic
                value:
                  type: CONTRACT
                  language: ar
                  identifications:
                  - type: UNIFIED_NUMBER
                    value: '7001272184'
              addressInfoArabic:
                summary: Address information request in Arabic
                value:
                  type: ADDRESS
                  language: ar
                  identifications:
                  - type: UNIFIED_NUMBER
                    value: '7001272184'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CorporateVerificationResponse'
              examples:
                fullInfoResponseArabic:
                  summary: Full information response (Arabic)
                  value:
                    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:
                      contract_copy_number: null
                      contract_date: null
                      commercial_registry:
                        national_number: '1010711252'
                        registration_number: '7001272184'
                        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_e_commerce: 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_id: 1
                        nationality:
                          ar: السعودية
                          en: null
                      entity_type:
                        id: 1
                        name:
                          ar: شركة ذات مسؤولية محدودة
                          en: null
                        form_id: 1
                        form_name:
                          ar: ذات مسؤولية محدودة
                          en: null
                        characters:
                        - id: 3
                          ar: غير ربحية خاصة
                          en: null
                      status:
                        id: 1
                        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: TestEmail@mail.com
                        website_url: www.google.com
                      e_commerce:
                        e_store:
                        - authentication_platform_url: www.google.com
                          store_url: www.google.com
                          store_activities:
                          - id: '476201'
                            ar: صناعة زبدة المكسرات
                            en: null
                      capital_information:
                        currency_id: 1
                        currency:
                          ar: ريال سعودي
                          en: null
                        contribution_capital:
                          type_id: 1
                          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_id: 2
                          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_id: 2
                            type:
                              ar: xx
                              en: null
                            class_reference_id: 1
                            class_name:
                              ar: xx
                              en: null
                      fiscal_year:
                        is_first: true
                        calendar_type_id: 1
                        calendar_type:
                          ar: ميلادي
                          en: null
                        end_month: 12
                        end_day: 30
                        end_year: null
                      parties:
                      - name:
                          ar: السيد عبدالعزيز احمد خالد الثنيان
                          en: null
                        type_id: 11
                        type:
                          ar: جمعية خيرية/ مؤسسة أهلية
                          en: null
                        identity:
                          id: '1234567890'
                          type_id: 1
                          type:
                            ar: هوية وطنية
                            en: null
                        partnership:
                        - id: 8
                          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
                        partner_profit_loss_distribution: null
                        guardian: null
                      management:
                        structure_id: 3
                        structure_name:
                          ar: مجلس مديرين
                          en: null
                        dismissal_method: null
                        managers:
                        - name:
                            ar: السيد عبدالعزيز احمد خالد الثنيان
                            en: null
                          type_id: 1
                          type:
                            ar: سعودي
                            en: null
                          is_licensed: true
                          identity:
                            id: '1234567890'
                            type_id: 1
                            type:
                              ar: هوية وطنية
                              en: null
                          nationality:
                            id: 113
                            type:
                              ar: سعودي
                              en: null
                          positions:
                          - id: 8
                            ar: عضو
                            en: null
                        management_board: null
                        directors_board: null
                      liquidators:
                      - name:
                          ar: عبدالله سالم هليل الشمري
                          en: null
                        type_id: 1
                        type:
                          ar: فرد سعودي
                          en: null
                        identity:
                          id: '2345678901'
                          type_id: 1
                          type:
                            ar: هوية وطنية
                            en: null
                        nationality:
                          id: 113
                          type:
                            ar: سعودي
                            en: null
                        positions:
                        - id: 8
                          ar: عضو
                          en: null
                      activities:
                      - id: '162910'
                        ar: أنشطة أخرى خاصة بصناعة نشر الأخشاب
                        en: null
                      - id: '477340'
                        ar: صناعة السلالم والدرابزينات
                        en: null
                      notification_channel: null
                      partner_decision: null
                      additional_decision_text: null
                      set_aside_details: null
                      articles: null
                      additional_articles: null
                      addresses: null
                fullInfoResponseEnglish:
                  summary: Full information response (English)
                  value:
                    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:
                      contract_copy_number: null
                      contract_date: null
                      commercial_registry:
                        national_number: '1010711252'
                        registration_number: '7001272184'
                        version_number: 1
                      company_name:
                        ar: null
                        en: Test Trading Company
                      name_language:
                        id: 1
                        description:
                          ar: null
                          en: Arabic
                      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_e_commerce: true
                      headquarters:
                        city_id: 1
                        city_name:
                          ar: null
                          en: Riyadh
                      license:
                        is_license_based: false
                        issuer_national_number: '123456789'
                        issuer_name:
                          ar: null
                          en: License Issuer
                      partners:
                        nationality_id: 1
                        nationality:
                          ar: null
                          en: Saudi
                      entity_type:
                        id: 1
                        name:
                          ar: null
                          en: Limited Liability Company
                        form_id: 1
                        form_name:
                          ar: null
                          en: Limited Liability
                        characters:
                        - id: 3
                          ar: null
                          en: Private Non-Profit
                      status:
                        id: 1
                        ar: null
                        en: Active
                      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: TestEmail@mail.com
                        website_url: www.google.com
                      e_commerce:
                        e_store:
                        - authentication_platform_url: www.google.com
                          store_url: www.google.com
                          store_activities:
                          - id: '476201'
                            ar: null
                            en: Nut butter manufacturing
                      capital_information:
                        currency_id: 1
                        currency:
                          ar: null
                          en: Saudi Riyal
                        contribution_capital:
                          type_id: 1
                          type:
                            ar: null
                            en: Cash and In-kind
                          cash_capital: 75000
                          in_kind_capital: 75000
                          contribution_value: 100
                          total_cash_contribution: 750
                          total_in_kind_contribution: 750
                        stock_capital:
                          type_id: 2
                          type:
                            ar: null
                            en: Stock Type
                          capital: 12000
                          announced_capital: 1244
                          paid_capital: 12333
                          cash_capital: 1111
                          in_kind_capital: 111
                          stocks:
                          - count: 11
                            value: 12
                            type_id: 2
                            type:
                              ar: null
                              en: Stock Type
                            class_reference_id: 1
                            class_name:
                              ar: null
                              en: Stock Class
                      fiscal_year:
                        is_first: true
                        calendar_type_id: 1
                        calendar_type:
                          ar: null
                          en: Gregorian
                        end_month: 12
                        end_day: 30
                        end_year: null
                      parties:
                      - name:
                          ar: null
                          en: Mr. Abdulaziz Ahmed Khaled Al-Thunaian
                        type_id: 11
                        type:
                          ar: null
                          en: Charitable Association/Private Foundation
                        identity:
                          id: '1234567890'
                          type_id: 1
                          type:
                            ar: null
                            en: National ID
                        partnership:
                        - id: 8
                          ar: null
                          en: Member
                        partner_share:
                          cash_contribution_count: 250
                          in_kind_contribution_count: 250
                          total_contribution_count: 500
                        nationality: null
                        license_number: null
                        commercial_registration_number: null
                        partner_profit_loss_distribution: null
                        guardian: null
                      management:
                        structure_id: 3
                        structure_name:
                          ar: null
                          en: Board of Directors
                        dismissal_method: null
                        managers:
                        - name:
                            ar: null
                            en: Mr. Abdulaziz Ahmed Khaled Al-Thunaian
                          type_id: 1
                          type:
                            ar: null
                            en: Saudi
                          is_licensed: true
                          identity:
                            id: '1234567890'
                            type_id: 1
                            type:
                              ar: null
                              en: National ID
                          nationality:
                            id: 113
                            type:
                              ar: null
                              en: Saudi
                          positions:
                          - id: 8
                            ar: null
                            en: Member
                        management_board: null
                        directors_board: null
                      liquidators:
                      - name:
                          ar: null
                          en: Abdullah Salem Helel Al-Shammari
                        type_id: 1
                        type:
                          ar: null
                          en: Saudi Individual
                        identity:
                          id: '2345678901'
                          type_id: 1
                          type:
                            ar: null
                            en: National ID
                        nationality:
                          id: 113
                          type:
                            ar: null
                            en: Saudi
                        positions:
                        - id: 8
                          ar: null
                          en: Member
                      activities:
                      - id: '162910'
                        ar: null
                        en: Other activities of manufacture of wood sawing
                      - id: '477340'
                        ar: null
                        en: Manufacture of stairs and handrails
                      notification_channel: null
                      partner_decision: null
                      additional_decision_text: null
                      set_aside_details: null
                      articles: null
                      additional_articles: null
                      addresses: null
                contractResponseArabic:
                  summary: Contract information response (Arabic)
                  value:
                    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:
                      contract_copy_number: 1
                      contract_date: '2025-02-23'
                      commercial_registry:
                        national_number: '1010711252'
                        registration_number: '7001272184'
                        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_e_commerce: true
                      headquarters:
                        city_id: 1
                        city_name:
                          ar: الرياض
                          en: null
                      license:
                        is_license_based: true
                        issuer_national_number: '76537'
                        issuer_name:
                          ar: وزارة التجارة
                          en: null
                      partners:
                        nationality_id: 1
                        nationality:
                          ar: السعودية
                          en: null
                      entity_type:
                        id: 1
                        name:
                          ar: شركة
                          en: null
                        form_id: 1
                        form_name:
                          ar: ذات مسؤولية محدودة
                          en: null
                        characters:
                        - id: 3
                          ar: ذات مسؤولية محدودة
                          en: null
                      status:
                        id: 1
                        ar: فعال
                        en: null
                      confirmation_date:
                        gregorian: '2003-10-05'
                        hijri: '1424-07-28'
                      reactivation_date: null
                      suspension_date: null
                      deletion_date: null
                      contact_info:
                        phone_number: 011256398
                        mobile_number: '050111101'
                        email: TestEmail@mail.com
                        website_url: www.example.com
                      e_commerce:
                        e_store:
                        - authentication_platform_url: www.example.com
                          store_url: www.example.com
                          store_activities:
                          - id: '476201'
                            ar: صناعة زبدة المكسرات
                            en: null
                      capital_information:
                        currency_id: 1
                        currency:
                          ar: ريال سعودي
                          en: null
                        contribution_capital:
                          type_id: 1
                          type:
                            ar: نقدي
                            en: null
                          cash_capital: 75000
                          in_kind_capital: 0
                          contribution_value: 100
                          total_cash_contribution: 750
                          total_in_kind_contribution: 0
                        stock_capital:
                          type: null
                          capital: null
                          announced_capital: null
                          paid_capital: null
                          cash_capital: null
                          in_kind_capital: null
                          stocks: null
                      fiscal_year:
                        is_first: true
                        calendar_type_id: 2
                        calendar_type:
                          ar: هجري
                          en: null
                        end_month: 12
                        end_day: 30
                        end_year: null
                      parties:
                      - name:
                          ar: وقف
                          en: null
                        type_id: 11
                        type:
                          ar: وقف
                          en: null
                        identity:
                          id: '7111111111'
                          type_id: 1
                          type:
                            ar: رقم صك الوقف
                            en: null
                        partnership:
                        - id: 2
                          ar: مؤسس
                          en: null
                        partner_share:
                          cash_contribution_count: 0
                          in_kind_contribution_count: 0
                          total_contribution_count: 0
                        nationality: null
                        license_number: null
                        commercial_registration_number: null
                        partner_profit_loss_distribution:
                          profit_distribution: 0
                          loss_distribution: 0
                        guardian: null
                      management:
                        structure_id: 1
                        structure_name:
                          ar: مديران أو أكثر
                          en: null
                        dismissal_method:
                          ar: بقرار من مجلس الإدارة
                          en: null
                        managers:
                        - name:
                            ar: محمد أحمد علي
                            en: null
                          type_id: 1
                          type:
                            ar: مقيم
                            en: null
                          is_licensed: true
                          identity:
                            id: '2123456789'
                            type_id: 1
                            type:
                              ar: هوية مقيم
                              en: null
                          nationality:
                            id: 113
                            type:
                              ar: سعودي
                              en: null
                          positions:
                          - id: 2
                            ar: مدير تنفيذي
                            en: null
                        management_board:
                          meeting_quorum_id: 1
                          meeting_quorum_name:
                            ar: جميع المديرين
                            en: null
                          can_delegate_attendance: true
                          term_years: 3
                          way_of_work:
                            ar: اجتماعات شهرية
                            en: null
                          meeting_place:
                            ar: مقر الشركة
                            en: null
                          additional_text: null
                          positions:
                          - id: 1
                            name:
                              ar: رئيس
                              en: null
                        directors_board:
                          member_count: 5
                          term_years: 3
                          value: 10000
                          value_max: 50000
                          way_of_work:
                            ar: اجتماعات ربع سنوية
                            en: null
                          meeting_place:
                            ar: مقر الشركة
                            en: null
                          meeting_quorum: 3
                          meeting_legal_quorum: 4
                          can_delegate_attendance: true
                          board_call_mechanism:
                            ar: إشعار كتابي
                            en: null
                          membership_expiry_terms:
                            ar: نهاية الفترة أو الاستقالة
                            en: null
                          additional_text: null
                          rewards:
                          - id: '1'
                            name:
                              ar: مكافأة سنوية
                              en: null
                          positions:
                          - id: 1
                            name:
                              ar: رئيس مجلس الإدارة
                              en: null
                      liquidators: nu

# --- truncated at 32 KB (108 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/lean-technologies/refs/heads/main/openapi/lean-technologies-corporate-verification-api-openapi.yml