Business Report
Business Report (Best Match)
Section titled “Business Report (Best Match)”The Business Report API with the “best match” option allows you to retrieve a comprehensive, detailed report for the single most probable business entity match in one step. This is ideal when you have high confidence in your input data (such as precise name and address) and want to skip the “list of similar” step.
Purpose
Section titled “Purpose”Use this API when you need a direct, detailed report for the best-matching business entity based on your input. The system processes your search criteria, identifies the most likely match, and returns its full Business Profile Report.
Request Type
Section titled “Request Type”POST
Request URL
Section titled “Request URL” POST
https://api.trust2connect.ai/v2/search Request Headers
Section titled “Request Headers”| Header | Required | Value | Description |
|---|---|---|---|
| Authorization | Yes | Bearer t2c_access_token | OAuth 2.0 access token. Replace with the token from the Get Access Token endpoint |
| Content-Type | Yes | application/json | Specifies that the request body is in JSON format |
| X-Search-Option | Yes | best-match | This custom header instructs the API to perform a “best match” search and return only the most confident match |
Request Body
Section titled “Request Body”| Name | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name of entity |
address | string | Yes | Address of the entity |
city | string | Yes | City Name of the entity |
state | string | Yes | State Code of the entity |
zip | string | Yes | ZIP code of the entity |
ein | string | No | Employer Identification Number (EIN) of the entity |
Sample Request Body:
{ "name": "Melissas Natural Foods", "address": "90 Washington St Apt 19M", "city": "New York", "state": "NY", "zip": "10004"}Example Request
Section titled “Example Request”curl --location 'https://api.trust2connect.ai/v2/search' \--header 'Authorization: Bearer zIWLhzqFm1KTAn07lwY6nstiRwcd' \--header 'X-Search-Option: best-match' \--data '{ "name": "Melissas Natural Foods", "address": "90 Washington St Apt 19M", "city": "New York", "state": "NY", "zip": "10004"}'Example Response
Section titled “Example Response”The T2C API provides a comprehensive T2C Plus Score response that includes all available data with confidence scoring.
- Matched Entity: Contains comprehensive matching information including business and legal entity details, field-level confidence scoring with detailed explanations, entity status indicators, and relationship hierarchies
- Report:
- Executive Summary: JSON-formatted business summary with key highlights including company status, structure, years in business, and accreditations
- Controlling Party: Array of business owners, executives, and key personnel with their roles
- Government: Comprehensive governmental data including:
- Complete business and legal addresses with geocoordinates
- Business structure, type, and legal structure details
- IRS industry codes and NAICS/SIC classifications
- Registration numbers and incorporation dates
- Active status indicators with explanations (federal filings, legal entity status, regulatory filings, SOS status)
- Employee count and revenue information
- Dissolution date information
- OFAC and non-profit status
- Scores: Advanced scoring metrics including:
- Active Score: Probability (0-100) of company being operationally and legally active with detailed explanation
- Commercial Viability Score: 3-year forward-looking assessment with:
- Overall viability score (0-100)
- Key factors analysis (Business Growth, Financial Strength, Data Completeness, Macroeconomic Trends, Business/Industry Stability)
- Ranked key drivers for each factor with positive/neutral/negative direction indicators
- Web: Web-sourced data including:
- Company website, domain, and WHOIS information
- Controlling parties from web sources
- Association ratings (BBB accreditation and rating)
- Review aggregates from Yelp, Google, and BBB platforms
- Additional NAICS codes and alternate business names
- Revenue estimates and years in business
- Parent Status: Corporate relationship (Ultimate Parent, Parent and Child, Child, Sole)
- T2C ID: Unique Trust2Connect identifier
Show Example Response for Business Profile Report
{ "matched_entity": { "business_address_line_1": "90 Washington St Apt 19M", "business_address_line_2": null, "business_city": "New York", "business_country": "US", "business_name": "MELISSA'S NATURAL FOODS, LLC", "business_state": "NY", "business_zip": "10006", "dba_match_name": "MELISSA'S NATURAL FOODS", "display_name": "MELISSA'S NATURAL FOODS, LLC", "entity_active_indicator": "1", "entity_ein": null, "entity_parent_child": "Sole", "field_match_confidence": { "business_address": { "confidence": "Low", "explanation": "Search Address does not match with the Business Address on file", "score": 25.0 }, "business_name": { "confidence": "Low", "explanation": "Search Name does not match with the Business Name on file", "score": 54.03 }, "business_state": { "confidence": "High", "explanation": "Search State matches with the Business State on file", "score": 100.0 }, "dba_name": { "confidence": "High", "explanation": "Search Name matches with an alternate name", "score": 100.0 }, "jurisdiction_state": { "confidence": "High", "explanation": "Search State matches the State of Jurisdiction on file", "score": 100.0 }, "legal_address": { "confidence": "Low", "explanation": "Search Address does not match with the Legal Address on file", "score": 25.0 }, "legal_name": { "confidence": "Low", "explanation": "Search Name does not match with the Legal Name on file", "score": 54.03 }, "legal_state": { "confidence": "High", "explanation": "Search State matches with the Legal State on file", "score": 100.0 }, "location_address": { "confidence": "Low", "explanation": "Search Address does not match with any alternate Location Address", "score": 0.0 }, "location_city": { "confidence": "Low", "explanation": "Search City does not match with any alternate Location City", "score": 0.0 }, "location_state": { "confidence": "Low", "explanation": "Search State does not match with any alternate Location State", "score": 0.0 } }, "jurisdiction_state": "ny", "legal_address_line_1": "90 Washington St Apt 19M", "legal_address_line_2": null, "legal_city": "New York", "legal_country": "US", "legal_entity_active_indicator": "1", "legal_entity_current_status": "Active", "legal_entity_current_status_raw": "Active", "legal_entity_ein": "12-3456789", "legal_entity_jurisdiction_code": "US_NY", "legal_entity_parent_status": "Sole", "legal_name": "MELISSA'S NATURAL FOODS, LLC", "legal_state": "NY", "legal_zip": "10006", "location_match": { "bq_id": "null", "legal_entity_id": "null", "location_active_indicator": "null", "location_address_city": "null", "location_address_line_1": "null", "location_address_line_2": "null", "location_address_score": "null", "location_address_state": "null", "location_address_zip5": "null", "location_address_zip9": "null", "location_city_score": "null", "location_classes": "null", "location_name": "null", "location_state_score": "null", "location_types": "null", "t2c_id": "null" }, "location_match_note": "No additional other locations found matching address/city criteria", "match_explanation": "High confidence. We matched this record because the entity name is a strong match, the name matches an alternate name, the legal state matches the search state, the jurisdiction state matches the search state.", "t2c_id": "92432ha7-5fc8-4751-b5e3-f249f27e32g5" }, "report": { "controlling_party": [], "executive_summary": "{\"business_summary\": [\"Active single-entity organization in New York, operating as a Limited Liability Company, with 3 years in business.\", \"BBB rated A+.\", \"Active across all regulatory channels.\"]}", "government": { "selected_entity": { "all_names": [ "MELISSA'S NATURAL FOODS", "MELISSA'S NATURAL FOODS, LLC", "MELISSAS NATURAL FOODS", "MELISSA FOODS" ], "business_address": { "addressLineOne": "90 Washington St Apt 19M", "addressLineTwo": null, "city": "New York", "country": "US", "county": "New York County", "location": { "latitude": "40.7074", "longitude": "-74.0132" }, "state": "New York", "stateCode": "NY", "zipCode": "10006" }, "business_name": "MELISSA'S NATURAL FOODS, LLC", "business_structure": "Single-entity organization", "business_type": "Non Employer", "company_federal_filings": "1", "company_federal_filings_explanation": "The organization has filed with the IRS or other federal agencies in the last two years or has an active online presence.", "company_legal_entity_active_indicator": "1", "company_legal_entity_active_indicator_explanation": "One or more legal entities in the organization is active within its state of jurisdiction.", "company_regulatory_filings": "1", "company_regulatory_filings_explanation": "The organization has filed with one or more regulatory agencies within the last two years.", "current_sos_status": "Good Standing", "current_sos_status_explanation": "Secretary of State reports this business as \"Good Standing\".", "dissolution_date": null, "dissolution_date_explanation": "No dissolution date is on record for this organization's primary legal entity.", "entity_retrieved_at": "06-18-2026", "incorporation_date": "03-02-2022", "irs": { "irsIndustryCodes": "445298", "irsIndustryCodesAll": "445298", "irsIndustryNames": "All Other Specialty Food Retailers", "irsIndustryNamesAll": "All Other Specialty Food Retailers", "irsSectorCode": "44", "irsSectorName": "Retail Trade", "irsSubsectorCode": "4452", "irsSubsectorName": "Specialty Food Stores" }, "is_company_ofac": "No", "is_non_profit": "No", "jurisdiction_state": "NY", "legal_address": { "addressLineOne": "90 Washington St Apt 19M", "addressLineTwo": null, "city": "New York", "country": "US", "county": "New York County", "location": { "latitude": "40.7074", "longitude": "-74.0132" }, "state": "New York", "stateCode": "NY", "zipCode": "10006" }, "legal_entity_active_indicator": "1", "legal_name": "MELISSA'S NATURAL FOODS, LLC", "legal_structure": "Limited Liability Company", "naics": { "naicsCode": "445298", "naicsCodesAll": "445298", "naicsName": "All Other Specialty Food Retailers", "naicsNamesAll": "All Other Specialty Food Retailers", "naicsSectorCode": "44", "naicsSectorName": "Retail Trade" }, "no_of_employees": "2", "phone": "+1 (212) 555-0163", "registration_number": "6740960", "report_date": "12-31-2026", "revenue": "150028", "sic_codes": { "sicCode": "5499", "sicCodesAll": "5499", "sicName": "Miscellaneous Food Stores", "sicNamesAll": "Miscellaneous Food Stores", "sicSectorCode": "54", "sicSectorCodesAll": "54", "sicSectorName": "Food Stores", "sicSectorNamesAll": "Food Stores" }, "standardized_status": "Active", "subsidiary_indicator_explanation": "Structured as a Partnership, LLC, or other entity that is not a corporation.", "tax_id": { "ein": "12-3456789" }, "years_in_business": 3 } }, "parent_status": "Sole", "scores": { "active_score": { "score": 98.5, "score_explanation": "The score of 0.985 indicates a very high probability of the company being operationally and legally active. This score is driven primarily by factors such as the company being operationally active, legally active, and in good standing with regulatory agencies." }, "commercial_viability_score": { "year_3": { "key_factors": [ { "description": "Strong levels, positive changes, and consistent growth of key financial indicators.", "direction": "positive", "key_driver": [ { "description": "Revenue up (1-yr)", "rank": 1 }, { "description": "Net Income above historical norm", "rank": 2 }, { "description": "Strong asset utilization", "rank": 3 } ], "label": "Financial Strength", "rank": 1 }, { "description": "Strong stability with low levels and positive changes in industry small business delinquency.", "direction": "positive", "key_driver": [ { "description": "Sector delinquency down (1-yr)", "rank": 1 }, { "description": "Severe stress for sector down (1-yr)", "rank": 2 }, { "description": "Industry stability indicators strong", "rank": 3 } ], "label": "Business and Industry Stability", "rank": 2 }, { "description": "Strong levels and consistent growth of payroll and employment within the company.", "direction": "positive", "key_driver": [ { "description": "Payroll up (1-yr)", "rank": 1 }, { "description": "Employee growth stable", "rank": 2 }, { "description": "Employment levels healthy", "rank": 3 } ], "label": "Business Growth", "rank": 3 }, { "description": "No missing data for critical fields, indicating strong maturity and completeness of the business data.", "direction": "positive", "key_driver": [ { "description": "1-yr revenue growth data is available", "rank": 1 }, { "description": "Asset Turnover is available", "rank": 2 }, { "description": "3-yr payroll growth data is available", "rank": 3 } ], "label": "Data Completeness", "rank": 4 }, { "description": "High and worsening county-level unemployment rates, indicating an unfavorable environment.", "direction": "negative", "key_driver": [ { "description": "Rising local unemployment rate (3-mo)", "rank": 1 }, { "description": "Local unemployment rate above historical norm", "rank": 2 }, { "description": "Economic headwinds present", "rank": 3 } ], "label": "Macroeconomic Trends", "rank": 5 } ], "score": 95 } } }, "t2c_id": "92432ha7-5fc8-4751-b5e3-f249f27e32g5", "web": { "association_ratings": { "bbb": { "accreditation": "None", "accreditation_since": "N/A", "rating": "A+", "review_count": "N/A" } }, "general_information": { "address": { "addressLineOne": "90 Washington St Apt 19M", "addressLineTwo": null, "city": "New York", "country": "USA", "state": "New York", "stateCode": "NY", "type_of_address": "headquarters", "zipCode": "10006" }, "company_name": "MELISSA'S NATURAL FOODS, LLC", "controling_parties": [ { "name": "MELISSA ODEWACK", "role": "President" }, { "name": "PHILIPPE BONDON", "role": "Agent" } ], "domain": "https://melissafoods.com/", "naics": [ "445298: All Other Specialty Food Retailers" ], "other_names": [ "Melissa's Natural Foods", "Melissas Natural Foods", "Melissa Foods" ], "phone": "+1 (212) 555-0163", "revenue": "$150K", "website": "https://melissafoods.com/", "whois_information": { "WHOIS_Server": "whois.squarespace.com", "administrative_contact_email": "N/A", "administrative_contact_name": "N/A", "administrative_contact_number": "N/A", "creation_date": "03-02-2023", "domain_name": "MELISSAFOODS.COM", "expiration_date": "03-02-2027", "name_servers": [ "NS1.SQUARESPACE.COM", "NS2.SQUARESPACE.COM" ], "registrant_email": "N/A", "registrant_name": null, "registrant_phone": "N/A", "registrar": "Squarespace Domains LLC", "status": "clientTransferProhibited https://icann.org/epp#clientTransferProhibited", "updated_date": "03-15-2025" }, "years_in_business": "3" }, "reviews": [ { "average_rating": "4.3", "platform": "Yelp", "total_no_reviews": "12" }, { "average_rating": "4.5", "platform": "Google", "total_no_reviews": "25" }, { "average_rating": "N/A", "platform": "BBB", "total_no_reviews": "N/A" } ] } }, "search_version": "search2.0", "session_id": "31a79d0a-909e-42ef-bbb6-8854106883a2", "status": "success", "transaction_id": "req-123"}- transaction_id is a unique identifier generated for every request.