The Basic Business Profile check helps verify the authenticity of fundamental business information by comparing self-attested data against information found through web research. This guide explains how to run the check, what data to provide, and how to interpret the results.

​
Overview

The check verifies several key aspects of a business’s profile:

  • Business name and registration
  • Business description and activities
  • Industry classification
  • Operating status
  • Basic contact information

​
Running the Check

​
API Endpoint

POST https://api.parcha.ai/runCheck

​
Request Parameters

​
agent_key
string
required

Use "public-bdd" for business due diligence checks.

​
check_id
string
required

Use "kyb.basic_business_profile_check" for basic profile verification.

​
kyb_schema
object
required

The business information for verification.

​
Example Request

curl -X POST 'https://api.parcha.ai/runCheck' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
  "agent_key": "public-bdd",
  "check_id": "kyb.basic_business_profile_check",
  "kyb_schema": {
    "id": "basic-profile-check-001",
    "self_attested_data": {
      "business_name": "Parcha Labs Inc",
      "business_description": "Business verification and compliance platform",
      "industry": "Financial Technology Services",
      "website": "https://parcha.ai"
    }
  }
}'

​
Initial Response

{
  "id": "check-abc123",
  "status": "PENDING",
  "created_at": "2024-02-15T10:30:00Z",
  "updated_at": "2024-02-15T10:30:00Z",
  "agent_id": "public-bdd",
  "input_payload": {
    // Original request payload
  }
}

​
Check Process

The basic business profile check follows these steps:

  1. Data Collection

    • Gathers information from business registries
    • Searches web sources and directories
    • Analyzes business websites
    • Reviews professional networks

  2. Profile Analysis

    • Validates business name and registration
    • Verifies business description
    • Confirms industry classification
    • Cross-references contact information

  3. Consistency Check

    • Compares data across sources
    • Identifies discrepancies
    • Evaluates information reliability
    • Assesses overall profile consistency

​
Check Results

Once the check is complete, you can retrieve the results using the check ID. The results will include:

​
Response Structure

{
  "command_instance_id": "string",
  "command_name": "string",
  "command_id": "string",
  "answer": "string",
  "passed": "boolean",
  "verified_data": {
    "type": "BasicBusinessProfileCheckData",
    "business_name_found": {
      "source_id": "string",
      "evidence": "string",
      "business_name": "string"
    },
    "contact_info_found": { /* Populated object or null, see example for detailed structure */ },
    "business_industry_found": { /* Populated object or null, see example for detailed structure */ },
    "business_locations_found": [ /* Array of location objects, see example for detailed structure */ ],
    "investment_received_found": "object | null",
    "backed_by_found": "object | null",
    "estimated_range_num_employees_found": { /* Populated object or null, see example for detailed structure */ },
    "launched_or_incorporated_date_found": { /* Populated object or null, see example for detailed structure */ },
    "business_profile_urls": ["string", "..."],
    "social_media_urls": ["string", "..."],
    "business_profile_source_ids": ["string", "..."],
    "social_media_source_ids": ["string", "..."]
  },
  "check_result": {
    "type": "BasicBusinessProfileCheckResult",
    "business_name_match": {
      "exact_match": "boolean",
      "partial_match": "boolean",
      "source_ids": ["string", "..."],
      "explanation": "string",
      "name": "string"
    } | null,
    "business_description_match": { /* Populated object or null, see example for detailed structure */ } | null,
    "business_industry_match": { /* Populated object or null, see example for detailed structure */ } | null
  },
  "status": "string",
  "agent_instance_id": "string",
  "case_type": "string",
  "status_messages": [ /* Array of status message objects, see example for detailed structure */ ],
  "created_at": "string",
  "input_data": {
    "business_name": "string",
    "business_description": "string | null",
    "business_industry": "string | null"
  },
  "alerts": {},
  "recommendation": "string | null",
  "business_name": "string",
  "registered_business_name": "string | null"
}

​
Key Components

​
Business Identity Verification

  • Validates business name across multiple sources
  • Confirms business description accuracy
  • Verifies industry classification

​
Profile Analysis

  • Cross-references self-attested information
  • Evaluates consistency of business details
  • Identifies potential discrepancies

​
Data Sources

  • Official business websites
  • Business registrations
  • Industry directories
  • News and media coverage
  • Professional networks

​
Interpreting the Check Output

The Basic Business Profile Check provides a detailed output that helps you understand the verification process and its findings. Here’s a breakdown of an example output and how to interpret its key components.

​
Example Check Output

{
  "command_instance_id": "5a01581ceda046568e1b287dad57edb3",
  "command_name": "Basic Profile Check",
  "command_id": "kyb.basic_business_profile_check",
  "answer": "The business profile check has passed because the self-reported business name \\"Acme Innovations Ltd.\\" exactly matches the verified information. No business description or industry was self-reported, so these fields were not considered in the verification process.",
  "passed": true,
  "verified_data": {
    "type": "BasicBusinessProfileCheckData",
    "business_name_found": {
      "source_id": "sample123",
      "evidence": "The business name appears on their official website as 'Acme Innovations Ltd.'",
      "business_name": "Acme Innovations Ltd."
    },
    "contact_info_found": {
      "type": "FoundContactInfo",
      "email": {
        "source_id": "sample123",
        "evidence": "Contact email listed as contact@acmeinnovations.example.com",
        "email": "contact@acmeinnovations.example.com"
      },
      "phone": {
        "source_id": "sample456",
        "evidence": "Phone number listed on directory: (555) 123-4567",
        "phone": "(555) 123-4567"
      }
    },
    "business_industry_found": {
      "source_id": "sample789",
      "evidence": "Listed under 'Software Development' in industry catalog.",
      "industry": "Technology",
      "business_activity": "Develops and markets enterprise software solutions for various industries. Specializes in cloud-based CRM and data analytics tools."
    },
    "business_locations_found": [
      {
        "source_id": "sample123",
        "evidence": "Headquarters: 123 Innovation Drive, Tech City, TC 54321",
        "address": {
          "type": "AddressWithType",
          "street_1": "123 Innovation Drive",
          "street_2": "Suite 100",
          "city": "Tech City",
          "state": "TC",
          "country_code": "US",
          "postal_code": "54321",
          "address_type": "headquarters"
        }
      },
      {
        "source_id": "sample456",
        "evidence": "Branch Office: 456 Future Road, Metroville, MV 67890",
        "address": {
          "type": "AddressWithType",
          "street_1": "456 Future Road",
          "street_2": null,
          "city": "Metroville",
          "state": "MV",
          "country_code": "US",
          "postal_code": "67890",
          "address_type": "branch"
        }
      }
    ],
    "investment_received_found": null,
    "backed_by_found": null,
    "estimated_range_num_employees_found": {
        "source_id": "sample789",
        "evidence": "Company profile indicates 50-100 employees.",
        "estimated_range_num_employees": "50-100"
    },
    "launched_or_incorporated_date_found": {
        "source_id": "sample123",
        "evidence": "Established in 2010.",
        "launched_or_incorporated_date": "2010-03-15"
    },
    "business_profile_urls": [
      "https://www.acmeinnovations.example.com",
      "https://www.businessdirectory.example.com/acme-innovations"
    ],
    "social_media_urls": [
        "https://www.linkedin.example.com/company/acme-innovations"
    ],
    "business_profile_source_ids": [
      "sample123",
      "sample456",
      "sample789"
    ],
    "social_media_source_ids": [
        "sampleLinkedIn"
    ]
  },
  "check_result": {
    "type": "BasicBusinessProfileCheckResult",
    "business_name_match": {
      "exact_match": true,
      "partial_match": false,
      "source_ids": [
        "sample123"
      ],
      "explanation": "The business name \\"Acme Innovations Ltd.\\" appears in the verified source exactly as self-reported.",
      "name": "Acme Innovations Ltd."
    },
    "business_description_match": null,
    "business_industry_match": null
  },
  "status": "complete",
  "agent_instance_id": "437c1d2a29d9465a8fc1304e457942df",
  "case_type": "business",
  "status_messages": [
    {
      "updated_at": "2025-05-20T19:59:55.512531",
      "id": "6cf21f64-96a3-43cd-9791-004d6e633364",
      "timestamp": "2025-05-20T19:59:55.512544",
      "content": {
        "agent_key": "your-agent-key-here",
        "status": "Loading: WebPresence Data Loader...",
        "command_instance_id": "5a01581ceda046568e1b287dad57edb3",
        "command_id": "kyb.basic_business_profile_check",
        "command_name": "KYB Basic Business Profile Check",
        "is_agent_status": null,
        "agent_name": "Business Due Diligence Agent",
        "agent_instance_id": "437c1d2a29d9465a8fc1304e457942df",
        "command_args": null
      },
      "command_instance_id": "5a01581c-eda0-4656-8e1b-287dad57edb3",
      "created_at": "2025-05-20T19:59:55.512527",
      "job_id": "67664a52-96f2-4845-a74f-dc341fd0cc17",
      "event": "status",
      "agent_instance_id": "437c1d2a-29d9-465a-8fc1-304e457942df"
    }
  ],
  "created_at": "2025-05-20T19:59:52.994494",
  "input_data": {
    "business_name": "Acme Innovations Ltd.",
    "business_description": null,
    "business_industry": null
  },
  "alerts": {},
  "recommendation": null,
  "business_name": "ACME INNOVATIONS LTD.",
  "registered_business_name": null
}

​
Key Fields Explained

​
passed (boolean)

This field is a straightforward indicator of the check’s outcome.

  • true: The self-attested information (primarily the business name, in this example) aligns with the verified data found through research. If certain fields like business description or industry are not provided by the user, they are typically considered as matching by default, as per the check’s logic.
  • false: There are significant discrepancies between the self-attested information and the verified data. For instance, if the self-reported business name was “Acme Software” but research consistently showed “Acme Hardware,” the check would likely fail. Or, if the business claimed to be in “Retail” but was found to be in a “High-Risk Financial Services” industry.

​
verified_data (object)

This section contains the comprehensive profile of the business as assembled from various online sources. It represents the “ground truth” that Parcha discovered.

  • business_name_found: Details about the business name as found by research, including the source and evidence.
    • business_name: “Acme Innovations Ltd.” (The name found by Parcha)
  • contact_info_found: Contact details like email and phone numbers.
  • business_industry_found: The industry and specific business activities identified.
    • industry: “Technology”
    • business_activity: “Develops and markets enterprise software solutions…”
  • business_locations_found: An array of physical addresses associated with the business, each with source and evidence.
    • Address 1: “123 Innovation Drive, Tech City…” (headquarters)
    • Address 2: “456 Future Road, Metroville…” (branch)
  • estimated_range_num_employees_found: If found, an estimation of the company’s size.
    • estimated_range_num_employees: “50-100”
  • launched_or_incorporated_date_found: The date the business was reportedly established or incorporated.
    • launched_or_incorporated_date: “2010-03-15”
  • business_profile_urls: URLs to official business profiles (e.g., company website, directory listings).
  • social_media_urls: URLs to social media pages associated with the business.
  • business_profile_source_ids and social_media_source_ids: Internal identifiers for the sources of this information.

Other fields like investment_received_found and backed_by_found would be populated if such information was discovered during the research phase.

​
check_result (object)

This section details the comparison between the input_data (what the user provided) and the verified_data (what Parcha found).

  • type: “BasicBusinessProfileCheckResult” - Identifies the type of check result.
  • business_name_match:
    • exact_match: true - Indicates if the self-reported name is an exact match to a verified name.
    • partial_match: false - Would be true if there was a close but not exact match (e.g., “Acme Innovations” vs “Acme Innovations Ltd.”).
    • source_ids: [“sample123”] - The source(s) that confirmed this match.
    • explanation: Provides a human-readable reason for the match status.
    • name: “Acme Innovations Ltd.” (The name that was compared).
  • business_description_match: null in this example because no business description was provided in the input_data. If a description had been provided, this section would detail whether it matched the verified_data.business_industry_found.business_activity.
  • business_industry_match: null for the same reason as above. If an industry had been provided, this would show how it compared to verified_data.business_industry_found.industry.

​
Other Important Fields

  • answer: An AI-generated summary explaining the overall outcome of the check in natural language.
  • input_data: Shows the information that was initially provided for the check (e.g., “Acme Innovations Ltd.” as business_name, with business_description and business_industry being null).
  • status_messages: A log of the different steps and API calls made during the check execution. This is useful for debugging or understanding the check’s progression.

By examining these sections, you can understand not only if the business profile passed verification but also why, based on the data found and how it compares to the information your system had on file.