Business Report
Business Report
Section titled “Business Report”The Business Report API is the second step in the Trust2Connect “Business Search & Match” workflow. After identifying a potential business match using the Business Search API, use this endpoint to retrieve a comprehensive, detailed report for a specific business entity.
Purpose
Section titled “Purpose”Fetch in-depth Business Profile Report for a single business entity, identified by its unique Trust2Connect ID (t2c_id). A valid session_id from a previous search request is required to ensure the report request is authorized and recent. The report includes government filings, website data, and other private information.
Request Type
Section titled “Request Type”GET
Request URL
Section titled “Request URL” GET
https://api.trust2connect.ai/v2/search?session_id={active_session_id}&t2c_id={t2c_id_for_report_fetch} 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 |
| X-Search-Option | Yes | list-of-similar | Confirms the t2c_id is from a “Business Search & Match” search, linking the report to the original search |
Parameters
Section titled “Parameters”| Query Param | Required | Description |
|---|---|---|
| session_id | Yes | The unique session_id from the Business Search API response. Valid for a limited time (default: 8 hours) |
| t2c_id | Yes | The Trust2Connect ID for the business entity. Must be from your previous Business Search API results. |
Example Request
Section titled “Example Request”curl --location 'https://api.trust2connect.ai/v2/search?session_id=<active_session_id>&t2c_id=<t2c_id_for_report_fetch>' \--header 'Authorization: Bearer uYCma6Si7T1rm7LArasFFl3bqvv2' \--header 'X-Search-Option: list-of-similar'Example Response
Section titled “Example Response”The T2C API provides a comprehensive T2C Plus Score response that includes all available data with confidence scoring.
- 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
- Session Information:
session_id: Active session identifierstatus: Request status (success/failure)transaction_id: Unique identifier for this request
Show Example Response for Business Profile Report
{ "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_entity_ein": "12-3456789", "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 and consistent growth of payroll and employment within the company.", "direction": "positive", "key_driver": [ { "description": "Company headcount above historical norm", "rank": 1 }, { "description": "Declining payroll (1-yr)", "rank": 2 }, { "description": "Declining payroll (5-yr)", "rank": 3 } ], "label": "Business Growth", "rank": 1 }, { "description": "Strong levels, positive changes, and consistent growth of key financial indicators.", "direction": "positive", "key_driver": [ { "description": "Asset base reduction", "rank": 1 }, { "description": "Extensive operational history", "rank": 2 }, { "description": "Company has multiple employees", "rank": 3 } ], "label": "Financial Strength", "rank": 2 }, { "description": "No missing data for critical fields, indicating strong maturity and completeness of the business data.", "direction": "positive", "key_driver": [ { "description": "3-yr employee growth data is available", "rank": 1 }, { "description": "EBITDA per employee is available", "rank": 2 }, { "description": "Revenue is available", "rank": 3 } ], "label": "Data Completeness", "rank": 3 }, { "description": "Moderate and stable county-level unemployment rates, indicating an average macroeconomic environment.", "direction": "neutral", "key_driver": [ { "description": "Local unemployment rate near historical norm", "rank": 1 }, { "description": "Stable local unemployment rate (3-mo)", "rank": 2 }, { "description": "Stable local unemployment rate (1-yr)", "rank": 3 } ], "label": "Macroeconomic Trends", "rank": 4 }, { "description": "Moderate stability with average levels and changes in industry small business delinquency.", "direction": "neutral", "key_driver": [ { "description": "3-mo industry delinquency (91-180 days) is stable", "rank": 1 }, { "description": "1-yr industry delinquency (91-180 days) is stable", "rank": 2 }, { "description": "3-mo industry delinquency (31-90 days) is stable", "rank": 3 } ], "label": "Business and Industry Stability", "rank": 5 } ], "score": 96 } } }, "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" } ] } }, "session_id": "bf9591ed-10dd-40a9-acb6-4380fcfbbda3", "status": "success", "transaction_id": "8a4d2c7e-9f3b-42e1-a6c8-5d1e3f8b9c4a"}- transaction_id is a unique identifier generated for every request.