Business Search
Business Search
Section titled “Business Search”The Business Search API is the first step in the Trust2Connect business verification workflow. It enables you to submit partial or complete business details to identify potential matches within the Trust2Connect database. This API performs a sophisticated search and returns a list of similar businesses, along with a unique session identifier for subsequent actions.
Purpose
Section titled “Purpose”This API allows applications to search for a business entity by providing essential identifying details such as name, address, and other relevant information. It is designed to handle varying levels of input specificity and provide a curated list of the most probable matches, along with necessary identifiers for further detailed reporting.
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 | list-of-similar | This custom header instructs the API to perform a “similar matches” search. It explicitly tells the system to return a list of up to 10 businesses that closely match the provided search criteria, rather than an exact match or a single result. This is crucial for the two-step verification process, allowing the user to select the correct entity from a set of possible matches. |
Request Body
Section titled “Request Body”The request body must be a JSON object containing the search criteria for the business. The system validates these inputs to ensure a meaningful search.
| Name | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Name of the entity |
address | string | No | Address of the entity |
city | string | No | City Name of the entity |
state | string | Yes | State Code of the entity |
zip | string | No | 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 490k1xOLh5AiVGLMfVlfSAOfWwxO' \--header 'X-Search-Option: list-of-similar' \--data '{ "name": "Melissas Natural Foods", "address": "90 Washington St Apt 19M", "city": "New York", "state": "NY", "zip": "10004"}'Example Response
Section titled “Example Response”Show Example Response
{ "search_result": [ { "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": "il", "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": null, "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" }, { "business_address_line_1": "300 Rockland Rd", "business_address_line_2": null, "business_city": "Lake Bluff", "business_country": "US", "business_name": "MARIANI ENTERPRISES INC.", "business_state": "NY", "business_zip": "60044", "dba_match_name": "MD NURSERY & LANDSCAPING", "display_name": "MARIANI ENTERPRISES, LLC", "entity_active_indicator": "1", "entity_ein": null, "entity_parent_child": "Ultimate Parent", "field_match_confidence": { "business_address": { "confidence": "High", "explanation": "Search Address matches with the Business Address on file", "score": 100.0 }, "business_name": { "confidence": "Low", "explanation": "Search Name does not match with the Business Name on file", "score": 22.99 }, "business_state": { "confidence": "High", "explanation": "Search State matches with the Business State on file", "score": 100.0 }, "dba_name": { "confidence": "Low", "explanation": "Search Name does not match with any alternate name", "score": 55.91 }, "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": 31.0 }, "legal_name": { "confidence": "Low", "explanation": "Search Name does not match with the Legal Name on file", "score": 22.99 }, "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": "il", "legal_address_line_1": "110 Albrecht Dr", "legal_address_line_2": null, "legal_city": "Lake Bluff", "legal_country": "US", "legal_entity_active_indicator": "1", "legal_entity_current_status": "Active", "legal_entity_current_status_raw": "Active", "legal_entity_ein": null, "legal_entity_jurisdiction_code": "US_NY", "legal_entity_parent_status": "Ultimate Parent", "legal_name": "MARIANI ENTERPRISES, LLC", "legal_state": "NY", "legal_zip": "60044", "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": "Additional other location lookup not needed based on address/city scores for the Ultimate Parent", "match_explanation": "Low confidence. We matched this record because the entity name is a partial match, the name matches an alternate name, the legal state matches the search state, the jurisdiction state matches the search state, the city matches, the address matches.", "t2c_id": "901c1e7f-7bba-4606-9f94-1c32f7146939" } ], "search_version": "search2.0", "session_expires_at": "Wed, 29 Jul 2026 11:37:50 GMT", "session_id": "bf9591ed-10dd-40a9-acb6-4380fcfbbda3", "status": "success", "total_entities": 2, "transaction_id": "2f8c9989-1639-47ad-b9d4-b63f67eb4f62"}- session_id - The unique session identifier to be used in subsequent Search API requests. Valid for a limited time (default: 8 hours).
- Employer Identification Number (EIN) is included in the response only if it was provided in the request and has a direct match. EIN is used for equality (exact) search, not for similarity search
- transaction_id is a unique identifier generated for every request