--- updatedAt: 2026-07-07T22:29:08.000Z agentTools: projectIndex: https://developer.trulioo.com/llms.txt --- # Business Search Calling this method will perform a business search. # OpenAPI definition ```json { "openapi": "3.0.1", "info": { "title": "Business Verification", "version": "v3" }, "servers": [ { "url": "https://api.trulioo.com" } ], "x-samples-languages": [ "curl", "node", "javascript", "ruby", "python" ], "paths": { "/v3/business/search": { "post": { "tags": [ "Business Search" ], "summary": "Business Search", "description": "Calling this method will perform a business search.", "requestBody": { "content": { "application/json-patch+json": { "schema": { "$ref": "#/components/schemas/BusinessSearchRequest" }, "example": { "SearchType": "Live", "Business": { "BusinessName": "ACME Consulting" }, "CountryCode": "US" } }, "application/json": { "schema": { "$ref": "#/components/schemas/BusinessSearchRequest" }, "example": { "SearchType": "Live", "Business": { "BusinessName": "ACME Consulting" }, "CountryCode": "US" } }, "text/json": { "schema": { "$ref": "#/components/schemas/BusinessSearchRequest" }, "example": { "SearchType": "Live", "Business": { "BusinessName": "ACME Consulting" }, "CountryCode": "US" } }, "application/*+json": { "schema": { "$ref": "#/components/schemas/BusinessSearchRequest" }, "example": { "SearchType": "Live", "Business": { "BusinessName": "ACME Consulting" }, "CountryCode": "US" } } } }, "responses": { "200": { "description": "Success", "content": { "text/plain": { "schema": { "$ref": "#/components/schemas/BusinessSearchResponse" }, "example": { "TransactionID": "c03ad3c9-da6b-452c-8a2e-fd1923973b99", "UploadedDt": "2015-02-19T13:25:50", "CountryCode": null, "ProductName": null, "Record": { "TransactionRecordID": "c47d485d-005a-4e0c-8ef0-06f16ddbaeb6", "RecordStatus": null, "DatasourceResults": [ { "Results": [ { "Index": "1", "BusinessName": "ACME Consulting", "MatchingScore": "1", "BusinessRegistrationNumber": "1234", "DUNSNumber": null, "JurisdictionOfIncorporation": "BC", "FullAddress": null, "BusinessStatus": "Active", "OriginalBusinessStatus": null, "TradeStyleName": null, "BusinessType": null, "Address": null, "TaxIDNumber": null } ], "DatasourceName": "Business Search Datasource", "Errors": [] } ], "Errors": [] }, "Errors": null } }, "application/json": { "schema": { "$ref": "#/components/schemas/BusinessSearchResponse" }, "example": { "TransactionID": "c03ad3c9-da6b-452c-8a2e-fd1923973b99", "UploadedDt": "2015-02-19T13:25:50", "CountryCode": null, "ProductName": null, "Record": { "TransactionRecordID": "c47d485d-005a-4e0c-8ef0-06f16ddbaeb6", "RecordStatus": null, "DatasourceResults": [ { "Results": [ { "Index": "1", "BusinessName": "ACME Consulting", "MatchingScore": "1", "BusinessRegistrationNumber": "1234", "DUNSNumber": null, "JurisdictionOfIncorporation": "BC", "FullAddress": null, "BusinessStatus": "Active", "OriginalBusinessStatus": null, "TradeStyleName": null, "BusinessType": null, "Address": null, "TaxIDNumber": null } ], "DatasourceName": "Business Search Datasource", "Errors": [] } ], "Errors": [] }, "Errors": null } }, "text/json": { "schema": { "$ref": "#/components/schemas/BusinessSearchResponse" }, "example": { "TransactionID": "c03ad3c9-da6b-452c-8a2e-fd1923973b99", "UploadedDt": "2015-02-19T13:25:50", "CountryCode": null, "ProductName": null, "Record": { "TransactionRecordID": "c47d485d-005a-4e0c-8ef0-06f16ddbaeb6", "RecordStatus": null, "DatasourceResults": [ { "Results": [ { "Index": "1", "BusinessName": "ACME Consulting", "MatchingScore": "1", "BusinessRegistrationNumber": "1234", "DUNSNumber": null, "JurisdictionOfIncorporation": "BC", "FullAddress": null, "BusinessStatus": "Active", "OriginalBusinessStatus": null, "TradeStyleName": null, "BusinessType": null, "Address": null, "TaxIDNumber": null } ], "DatasourceName": "Business Search Datasource", "Errors": [] } ], "Errors": [] }, "Errors": null } } } }, "400": { "description": "Your request could not be processed, there should be more details in the response." }, "401": { "description": "The user name and password you provided is not valid or you are using an account not configured to be an API user." }, "408": { "description": "The request took longer to process than we waited." }, "415": { "description": "You asked for a media type that we do not support. You should request application/json in the Content-Type header." }, "500": { "description": "An error happened on the server without a specific message." } } } } }, "components": { "schemas": { "Address": { "type": "object", "properties": { "UnitNumber": { "type": "string", "description": "Flat/Unit/Apartment number of address", "nullable": true }, "BuildingNumber": { "type": "string", "description": "House / Civic / Building number of address", "nullable": true }, "BuildingName": { "type": "string", "description": "Name of building", "nullable": true }, "StreetName": { "type": "string", "description": "Street name", "nullable": true }, "StreetType": { "type": "string", "description": "Street type of address (Typically St, Rd etc)", "nullable": true }, "City": { "type": "string", "description": "City", "nullable": true }, "Suburb": { "type": "string", "description": "Suburb / Subdivision / Municipality", "nullable": true }, "StateProvinceCode": { "type": "string", "description": "State or province of address. US sources expect 2 characters. Australian sources expect 2 or 3 characters.", "nullable": true }, "PostalCode": { "type": "string", "description": "ZIP Code or Postal Code", "nullable": true }, "Address1": { "type": "string", "description": "Address1", "nullable": true }, "AddressType": { "type": "string", "description": "Address Type", "nullable": true }, "StateProvince": { "type": "string", "description": "State Province", "nullable": true }, "Country": { "type": "string", "description": "", "nullable": true }, "CountryCode": { "type": "string", "description": "", "nullable": true } }, "additionalProperties": false, "description": "" }, "BusinessRecord": { "type": "object", "properties": { "TransactionRecordID": { "type": "string", "description": "The TransactionRecordID, this is the ID you will use to fetch the transaction again.", "nullable": true }, "RecordStatus": { "type": "string", "description": "'match' or 'nomatch' if the verification passed the rules configured on your account this will be 'match'.", "nullable": true }, "DatasourceResults": { "type": "array", "items": { "$ref": "#/components/schemas/BusinessResult" }, "description": "Results for each datasource that was queried", "nullable": true }, "Errors": { "type": "array", "items": { "$ref": "#/components/schemas/ServiceError" }, "description": "", "nullable": true } }, "additionalProperties": false, "description": "" }, "BusinessResult": { "type": "object", "properties": { "results": { "type": "array", "items": { "$ref": "#/components/schemas/Result" }, "description": "", "nullable": true }, "DatasourceName": { "type": "string", "description": "", "nullable": true }, "Errors": { "type": "array", "items": { "$ref": "#/components/schemas/ServiceError" }, "description": "", "nullable": true, "readOnly": true } }, "additionalProperties": false, "description": "" }, "BusinessSearchRequest": { "required": [ "CountryCode", "PackageId", "SearchType" ], "type": "object", "properties": { "Test": { "type": "boolean", "readOnly": true }, "SearchType": { "enum": [ "Demo" ], "type": "string", "default": "Demo", "description": "The type of search to perform. Please use 'Demo' to try it." }, "PackageId": { "maxLength": 36, "minLength": 0, "type": "string", "description": "The Package ID to run the transaction under which can be obtained by your Customer Success Manager or via a support ticket." }, "CallBackUrl": { "maxLength": 2083, "minLength": 0, "type": "string", "nullable": true }, "Timeout": { "type": "integer", "format": "int32", "nullable": true, "description": "If set, Trulioo will try to update the client synchronously within the timeout in seconds. If failed to accomplish, the transaction will be canceled." }, "ConsentForDataSources": { "type": "array", "items": { "type": "string" }, "description": "Some datasources required your customer provide consent to access them. Set that the customer has provided consent for each\r\ndatasource that requires one. If consent is not provided the datasource will not be queried.", "nullable": true }, "Business": { "$ref": "#/components/schemas/BusinessSearchRequest.BusinessSearchModel" }, "CountryCode": { "minLength": 1, "type": "string", "description": "The country code for which the verification needs to be performed." } }, "additionalProperties": false, "description": "" }, "BusinessSearchRequest.BusinessSearchModel": { "type": "object", "properties": { "BusinessName": { "maxLength": 250, "minLength": 0, "type": "string", "description": "Name of the business to be verified", "nullable": true }, "Website": { "maxLength": 250, "minLength": 0, "type": "string", "description": "Website of the business", "nullable": true }, "JurisdictionOfIncorporation": { "maxLength": 250, "minLength": 0, "type": "string", "description": "Jurisdiction Of Incorporation of the business to be verified", "nullable": true }, "dunsNumber": { "maxLength": 250, "minLength": 0, "type": "string", "description": "DUNS number of the business to be verified", "nullable": true }, "Location": { "$ref": "#/components/schemas/Location" } }, "additionalProperties": false, "description": "Business Object" }, "BusinessSearchResponse": { "type": "object", "properties": { "transactionID": { "type": "string", "description": "The id for the transaction it will be a GUID", "nullable": true }, "UploadedDt": { "type": "string", "description": "Time in UTC", "format": "date-time" }, "CountryCode": { "type": "string", "description": "The country code for which the verification was performed.", "nullable": true }, "ProductName": { "type": "string", "description": "Product Name", "nullable": true }, "Record": { "$ref": "#/components/schemas/BusinessRecord" }, "Errors": { "type": "array", "items": { "$ref": "#/components/schemas/ServiceError" }, "description": "Collection of record errors", "nullable": true } }, "additionalProperties": false, "description": "" }, "BusinessSearchResponseIndustryCode": { "type": "object", "properties": { "Code": { "type": "string", "nullable": true }, "Description": { "type": "string", "nullable": true } }, "additionalProperties": false }, "Location": { "type": "object", "properties": { "BuildingNumber": { "type": "string", "description": "House / Civic / Building number of home address", "nullable": true }, "BuildingName": { "type": "string", "description": "Name of building of home address", "nullable": true }, "UnitNumber": { "type": "string", "description": "Flat/Unit/Apartment number of home address", "nullable": true }, "StreetName": { "type": "string", "description": "Street name of primary residence", "nullable": true }, "StreetType": { "type": "string", "description": "Street type of primary residence (e.g. St, Rd etc)", "nullable": true }, "City": { "type": "string", "description": "City of home address", "nullable": true }, "Suburb": { "type": "string", "description": "Suburb / Subdivision / Municipality of home address", "nullable": true }, "County": { "type": "string", "description": "County / District of home address", "nullable": true }, "StateProvinceCode": { "type": "string", "description": "State of primary residence. US sources expect 2 characters. Australian sources expect 2 or 3 characters.", "nullable": true }, "Country": { "type": "string", "description": "Country of physical address (ISO 3166-1 alpha-2)", "nullable": true }, "PostalCode": { "type": "string", "description": "ZIP Code or Postal Code of home address", "nullable": true }, "poBox": { "type": "string", "description": "Post Office Box", "nullable": true }, "AdditionalFields": { "$ref": "#/components/schemas/LocationAdditionalFields" } }, "additionalProperties": false, "description": "" }, "LocationAdditionalFields": { "type": "object", "properties": { "Address1": { "type": "string", "description": "Address1 is available in certain countries. It can be used to pass a compiled address field instead of sending individual address attributes (such as UnitNumber, BuidlingNumber, BuildingName, StreetName and StreetType). \r\nGlobalGateway will provide a pass through of Address1 directly to connected datasources for the selected country. \r\nPlease note: each datasource requires the address fields to be configured in a certain manner, implementing and sending Address1 instead of individual address fields may affect your ability to verify this address.", "nullable": true } }, "additionalProperties": false, "description": "Additional Fields for Location" }, "Result": { "type": "object", "properties": { "Index": { "type": "string", "description": "", "nullable": true }, "BusinessName": { "type": "string", "description": "", "nullable": true }, "MatchingScore": { "type": "string", "description": "", "nullable": true }, "BusinessRegistrationNumber": { "type": "string", "description": "", "nullable": true }, "dunsNumber": { "type": "string", "description": "", "nullable": true }, "BusinessTaxIDNumber": { "type": "string", "description": "", "nullable": true }, "BusinessLicenseNumber": { "type": "string", "description": "", "nullable": true }, "JurisdictionOfIncorporation": { "type": "string", "description": "", "nullable": true }, "FullAddress": { "type": "string", "description": "", "nullable": true }, "BusinessStatus": { "type": "string", "description": "Business Status", "nullable": true }, "OriginalBusinessStatus": { "type": "string", "description": "Original Business Status", "nullable": true }, "TradeStyleName": { "type": "string", "description": "Trade Style Name", "nullable": true }, "BusinessType": { "type": "string", "description": "Business Type", "nullable": true }, "Address": { "$ref": "#/components/schemas/Address" }, "OtherBusinessNames": { "type": "array", "items": { "type": "string" }, "description": "", "nullable": true }, "Website": { "type": "string", "description": "", "nullable": true }, "Telephone": { "type": "string", "description": "", "nullable": true }, "TaxIDNumber": { "type": "string", "description": "", "nullable": true }, "TaxIDNumbers": { "type": "array", "items": { "type": "string" }, "description": "", "nullable": true }, "EmailAddress": { "type": "string", "description": "", "nullable": true }, "WebDomain": { "type": "string", "description": "", "nullable": true }, "WebDomains": { "type": "array", "items": { "type": "string" }, "description": "", "nullable": true }, "Naics": { "type": "array", "items": { "$ref": "#/components/schemas/BusinessSearchResponseIndustryCode" }, "description": "North American Industry Classification System", "nullable": true }, "Sic": { "type": "array", "items": { "$ref": "#/components/schemas/BusinessSearchResponseIndustryCode" }, "description": "Standard Industrial Classification", "nullable": true } }, "additionalProperties": false }, "ServiceError": { "type": "object", "properties": { "Code": { "type": "string", "description": "", "nullable": true }, "Message": { "type": "string", "description": "", "nullable": true } }, "additionalProperties": false, "description": "" } }, "securitySchemes": { "Bearer": { "type": "http", "description": "JWT Authorization header", "scheme": "bearer", "bearerFormat": "JWT" } } }, "security": [ { "Bearer": [] } ] } ```