LexisNexis KYB

LexisNexis KYB searches for a business and can retrieve a configurable business report for the selected entity. Use Search to compare possible business matches and obtain LexisNexis business identifiers. Use Report to retrieve the selected business’s available identity, industry, filings, assets, relationships, and other requested sections. The active Workflow Builder block ID is lexisnexis_kyb, its visible label is LexisNexis KYB, and it is available for business entities in the KYB underwriting group. LexisNexis publicly describes its SmartLinx business content as linking business, commercial, and public-record data. The exact TopBusinessSearch and TopBusinessReport API schemas require credentialed product documentation. The response shapes and field names on this page are therefore confirmed against Lendflow’s current integration fixtures; only the broader product capabilities are confirmed by public LexisNexis SmartLinx Business Report materials.

Operations

Lendflow service ID	Operation	Purpose	Dependency
`lexis_nexis_kyb_search`	`TopBusinessSearch`	Returns possible business matches and their LexisNexis business identifiers.	None.
`lexis_nexis_kyb_report`	`TopBusinessReport`	Returns the selected report sections for one business.	Requires LexisNexis business identifiers. Lendflow runs Search automatically when identifiers are not already stored.

Search and Report have separate request data, responses, timestamps, and Lendflow lifecycle statuses. Running Report can therefore create both a Search run and a Report run.

Requirements

Search

Application field	Requirement	Notes
Business legal name	Optional	Recommended for identifying the business.
Business address lines, city, state, and ZIP code	Optional	Recommended for match quality; state and ZIP code are validated against the stored country.
Business EIN	Optional	Normalized and validated when provided.
Business website and SIC code	Optional	Supporting business-match values.
Stored LexisNexis business selection ID	Optional	Overrides the business selected for a subsequent Report.
Primary owner first and last name	Optional	Supporting match values.
Primary owner telephone	Optional	Must be valid when provided.
Primary owner SSN	Optional	Normalized and validated when provided.
Primary owner email	Optional	Supporting match value.
Primary owner address	Optional	State and ZIP code are validated when provided.

Report

Application field	Requirement	Notes
LexisNexis business identifiers	Conditional	Required to select the report subject. Lendflow uses a stored business selection ID or identifiers from the first Search record; if neither is available, Search runs first.
Business legal name	Optional	Identifies the end-user company.
Primary owner telephone	Optional	Must be valid when provided.
Primary owner address	Optional	State and ZIP code are validated when provided.

Search-to-Report business selection

Lendflow resolves the Report subject in this order:

If the business has a stored sele_id, Lendflow sends that value as SeleID, OrgID, and UltID.
Otherwise, Lendflow uses the complete BusinessIds object from the first Search record.
If no Search identifiers are stored, Report runs Search first and stores the first record’s identifiers under the business’s top-business match.
If Search returns RecordCount: 0, Report cannot continue and Lendflow records No search results found..

Search can return multiple possible matches, but automatic Report selection uses the first record unless the business already has a selected sele_id. Confirm the intended entity before relying on a report.

Report options

Report accepts 28 user-selectable options. Each selected key is sent to LexisNexis with value 1; unselected keys are omitted. The Dashboard displays the labels below and requires at least one selection when a user runs Report manually.

Dashboard label	API option key	Requested report area
Include Registered Agents	`IncludeRegisteredAgents`	Registered-agent records.
Include Dun Brad Street	`IncludeDunBradStreet`	Dun & Bradstreet records.
Include UCC Filings Secureds	`IncludeUCCFilingsSecureds`	UCC filings where the business appears as a secured party.
Include Company Verification	`IncludeCompanyVerification`	Verification indicators for submitted company values.
Include Associated Businesses	`IncludeAssociatedBusinesses`	Businesses associated with the subject.
Include Industries	`IncludeIndustries`	SIC, NAICS, and available industry descriptions.
Include Parents	`IncludeParents`	Parent-company information.
Include Properties	`IncludeProperties`	Real-property records.
Include Aircrafts	`IncludeAircrafts`	Aircraft records.
Include Watercrafts	`IncludeWatercrafts`	Watercraft records.
Include Name Variations	`IncludeNameVariations`	Other names associated with the business.
Include Motor Vehicles	`IncludeMotorVehicles`	Motor-vehicle records.
Include Source Counts	`IncludeSourceCounts`	Source-document counts.
Include Incorporation	`IncludeIncorporation`	Incorporation records.
Include Internet Domains	`IncludeInternetDomains`	Internet-domain records.
Include Sanctions	`IncludeSanctions`	Sanctions-related results available to the account.
Include Experian Business Reports	`IncludeExperianBusinessReports`	Embedded Experian business-report information.
Include Professional Licenses	`IncludeProfessionalLicenses`	Professional-license records.
Include Business Registrations	`IncludeBusinessRegistrations`	Business-registration records.
Include Bankruptcies	`IncludeBankruptcies`	Bankruptcy records and counts.
Include Ops Sites	`IncludeOpsSites`	Operating-site addresses.
Include Finances	`IncludeFinances`	Available finance-related records.
Include UCC Filings	`IncludeUCCFilings`	UCC filing records where the business appears as a debtor.
Include Contacts	`IncludeContacts`	Current and prior contacts or executives.
Include Business Insight	`IncludeBusinessInsight`	Business-insight information available to the account.
Include Liens Judgments	`IncludeLiensJudgments`	Lien and judgment records and counts.
Include IRS 5500	`IncludeIRS5500`	IRS Form 5500 records.
Include Connected Businesses	`IncludeConnectedBusinesses`	Connected-business records.

The option labels describe requested sections, not guaranteed results. Entitlements, source coverage, and the selected business determine which sections and records are returned.

Defaults and API names

Execution path	Option field	Behavior
Enrich Application Underwriting	`options.lexisNexisKybOptions`	Supply an array of option keys. If omitted or empty, Lendflow defaults to `["IncludeIndustries"]`. Unknown keys return HTTP `422`.
Business-credit v1 wrapper	`lexis_nexis_kyb_options`	Supply an array of option keys with `requested_products`. If omitted or empty, Lendflow defaults to `["IncludeIndustries"]`.
Dashboard manual run	User selection	Run selected models requires at least one option. Run with all models selects all 28 options.
Data Orchestration	No report-option selector	A Report run without service context uses the backend default, Include Industries.

Lendflow also sends BusinessReportFetchLevel: "S" on every Report request. This value is fixed and is not user-configurable.

Run through the application enrichment API

Call Enrich Business Credit Application for the application.
Set provider to lexis_nexis_kyb_search or lexis_nexis_kyb_report.
For Report, optionally include options.lexisNexisKybOptions with one or more values from the table above.
Include the applicable underwriting stage_id when required by the application’s workflow.
Confirm that the response contains data.onqueue: true.
Poll Get Commercial Data with services[]=lexis_nexis_kyb_search and/or services[]=lexis_nexis_kyb_report.
Read the operation-specific status under data.statuses.lexis_nexis and the provider payload under data.commercial_data.lexis_nexis.

data.onqueue: true means Lendflow queued the asynchronous job. It does not mean LexisNexis finished or found a business. The business-credit v1 wrapper uses Enrich Business Credit Application. Put the service IDs in requested_products and use lexis_nexis_kyb_options for Report options.

Run with Data Orchestration

The Search and Report services are available through the lexisnexis_kyb business block in Data Orchestration.

In the Lendflow Dashboard, open Builders > Data Orchestration.
Create or edit a template and add the applicable LexisNexis KYB operation from the KYB category.
Configure the conditions and connect each outcome, then save and publish the template. Data Orchestration uses the default Include Industries Report option.
Call Execute Data Orchestration with template_id and application_id. Include stage_id when applicable.
Confirm that the response contains data.executed: true.
Monitor the asynchronous run with List Data Orchestration Logs and Get Data Orchestration Log.
Retrieve enrichment data after the prerequisite service finishes.

data.executed: true means the orchestration run was accepted. Orchestration log statuses are started, interrupted, finished, and error; these describe the workflow run, not the LexisNexis result.

What the service returns

Response path	Meaning
`data.statuses.lexis_nexis.kyb_search`	Latest Lendflow lifecycle status or terminal message for Search.
`data.statuses.lexis_nexis.kyb_report`	Latest Lendflow lifecycle status or terminal message for Report.
`data.commercial_data.lexis_nexis.kyb_search.TopBusinessSearchResponseEx`	LexisNexis Search response wrapper.
`data.commercial_data.lexis_nexis.kyb_report.TopBusinessReportResponseEx`	LexisNexis Report response wrapper.
`data.request_data.lexis_nexis.kyb_search.TopBusinessSearchRequest`	Search request stored by Lendflow. It can contain sensitive owner and business identifiers.
`data.request_data.lexis_nexis.kyb_report.TopBusinessReportRequest`	Report request stored by Lendflow, including selected options and `ReportBy.BusinessIds`.

Search returns up to 20 records beginning with the first record and uses a 50-mile radius in the current Lendflow request. Report content varies with the selected options. A section can be absent, an object can be empty, an array can be empty, or a scalar can be null when the provider has no value or the section was not requested. Absence alone does not mean the overall request failed.

Representative response

This sanitized example combines the current Lendflow commercial-data wrapper with fields confirmed in exact Search and default Include Industries Report fixtures.

{
  "data": {
    "statuses": {
      "lexis_nexis": {
        "kyb_search": "Success",
        "kyb_report": "Success"
      }
    },
    "commercial_data": {
      "lexis_nexis": {
        "kyb_search": {
          "TopBusinessSearchResponseEx": {
            "@xmlns": "http://webservices.seisint.com/WsAccurint",
            "response": {
              "Header": {
                "Status": 0,
                "TransactionId": "example-search-transaction"
              },
              "RecordCount": 1,
              "Records": {
                "Record": [
                  {
                    "BusinessId": "example-business-id",
                    "BusinessIds": {
                      "OrgID": 123456701,
                      "UltID": 123456702,
                      "SeleID": 123456700
                    },
                    "Best": {
                      "CompanyNameInfo": {
                        "CompanyName": "EXAMPLE COMPANY LLC"
                      },
                      "IsActive": false,
                      "IsDefunct": false,
                      "TINInfo": {
                        "TINInfoMatch": false
                      },
                      "AddressInfo": {
                        "Address": {
                          "City": "ANYTOWN",
                          "State": "NY",
                          "Zip5": "10001"
                        }
                      }
                    }
                  }
                ]
              }
            }
          }
        },
        "kyb_report": {
          "TopBusinessReportResponseEx": {
            "@xmlns": "http://webservices.seisint.com/WsAccurint",
            "response": {
              "Header": {
                "Status": 0,
                "QueryId": "example-query-id",
                "TransactionId": "example-report-transaction"
              },
              "Businesses": {
                "Business": [
                  {
                    "BestSection": {
                      "CompanyName": "EXAMPLE COMPANY LLC",
                      "YearStarted": 2018,
                      "YearsInBusiness": 1,
                      "IsActive": false,
                      "IsDefunct": false
                    },
                    "IndustrySection": {
                      "IndustryRecords": {
                        "IndustryRecord": [
                          {
                            "SICs": {
                              "SIC": [
                                {
                                  "SICCode": "7336",
                                  "SICCodeDescription": "Graphic Design"
                                }
                              ]
                            },
                            "NAICSs": {
                              "NAICS": [
                                {
                                  "NAICS": "541430",
                                  "NAICSDescription": "Graphic Design"
                                }
                              ]
                            }
                          }
                        ]
                      }
                    }
                  }
                ]
              }
            }
          }
        }
      }
    },
    "request_data": {
      "lexis_nexis": {
        "kyb_report": {
          "TopBusinessReportRequest": {
            "Options": {
              "IncludeIndustries": 1,
              "BusinessReportFetchLevel": "S"
            },
            "ReportBy": {
              "BusinessIds": {
                "OrgID": 123456701,
                "UltID": 123456702,
                "SeleID": 123456700
              }
            }
          }
        }
      }
    }
  }
}

Response attributes

Lendflow wrapper

Attribute	Type	Meaning	Null or optional behavior
`data.statuses.lexis_nexis.kyb_search`	String	Search lifecycle status or terminal message.	Can be absent before the service is available in the response.
`data.statuses.lexis_nexis.kyb_report`	String	Report lifecycle status or terminal message.	Can be absent before Report starts.
`data.commercial_data.lexis_nexis.kyb_search`	Object	Latest stored Search provider response.	`null` or absent until a Search response is stored.
`data.commercial_data.lexis_nexis.kyb_report`	Object	Latest stored Report provider response.	`null` or absent until a Report response is stored.
`data.request_data.lexis_nexis.kyb_report`	Object	Latest stored Report request.	Can be absent before Report starts. Treat its IDs and submitted values as sensitive.

Provider Search response

Attribute	Type	Meaning	Null or optional behavior
`TopBusinessSearchResponseEx`	Object	Root Search response wrapper.	Present when LexisNexis returns a parseable Search payload.
`@xmlns`	String	LexisNexis XML namespace represented in JSON.	Provider metadata; it can be omitted by nonstandard fixtures.
`response`	Object	Contains the provider header and matching records.	Can contain header exceptions instead of complete records.
`Header.Status`	Number	Provider response status code. Lendflow success fixtures use `0`.	Do not interpret undocumented nonzero codes without LexisNexis’s credentialed schema.
`Header.TransactionId`	String	Provider transaction identifier.	`QueryId` can also be returned but is not present in every fixture.
`RecordCount`	Number or numeric string	Number of Search records returned.	`0` causes Lendflow’s no-results outcome.
`Records.Record`	Array	Possible business matches in provider order.	Absent when no records are returned.
`Record.BusinessId`	String	Provider business identifier returned for the match.	Can be absent. Report selection uses `BusinessIds`, not this value.
`Record.BusinessIds`	Object	Provider identifiers used to target later reports.	Individual ID types can be `0` or absent.
`BusinessIds.OrgID`	Number or string	Organization-level identifier returned by LexisNexis.	Can be `0` when unavailable.
`BusinessIds.UltID`	Number or string	Highest-level associated-entity identifier returned by LexisNexis.	Can be `0` when unavailable.
`BusinessIds.SeleID`	Number or string	Legal-entity identifier independent of a particular address.	Can be `0` when unavailable.
`Record.Best`	Object	Best business information for the match.	Nested values appear only when available.
`Best.CompanyNameInfo.CompanyName`	String	Company name associated with the match.	Can be absent.
`Best.IsActive`	Boolean	Provider indicator that the business is active.	Can be absent; `false` is a result, not a Lendflow failure.
`Best.IsDefunct`	Boolean	Provider indicator that the business is defunct.	Can be absent; `false` means the indicator was not set in the returned record.
`Best.TINInfo.TINInfoMatch`	Boolean	Whether the returned TIN information matched the submitted TIN.	Can be absent when no TIN result is available.
`Best.AddressInfo.Address`	Object	Available address components for the match.	Individual address components can be absent.
`City`, `State`, `Zip5`	Strings	City, state code, and five-digit ZIP returned for the address.	Any component can be absent.

Provider Report response

Attribute	Type	Meaning	Null or optional behavior
`TopBusinessReportResponseEx`	Object	Root Report response wrapper.	Present when LexisNexis returns a parseable Report payload.
`response.Header.Status`	Number	Provider response status code. Lendflow success fixtures use `0`.	Provider status is separate from the Lendflow lifecycle status.
`response.Header.QueryId`	String	Provider query identifier.	Can be absent.
`response.Header.TransactionId`	String	Provider transaction identifier.	Can be absent.
`response.Businesses.Business`	Array	Businesses included in the report.	Can be empty or absent when no report business is returned.
`Business.BestSection`	Object	Best available identity and activity summary for the reported business.	Fields can be absent when unavailable.
`BestSection.CompanyName`	String	Reported company name.	Can be absent.
`BestSection.YearStarted`	Number	Reported or derived start year.	Can be absent; use `YearStartedDerived` from a complete response to determine whether it was derived.
`BestSection.YearsInBusiness`	Number	Provider-calculated years in business.	Can be absent.
`BestSection.IsActive`	Boolean	Provider active-business indicator.	`false` does not mean the API request failed.
`BestSection.IsDefunct`	Boolean	Provider defunct-business indicator.	`false` does not mean the API request failed.
`Business.IndustrySection`	Object	Industry information requested by `IncludeIndustries`.	Absent if not requested or not returned.
`IndustryRecords.IndustryRecord`	Array	Industry records associated with the business.	Can be empty.
`SICs.SIC`	Array	SIC codes and descriptions.	Can be empty or absent.
`SICCode`	String	Standard Industrial Classification code returned by LexisNexis.	Can be absent within an incomplete record.
`SICCodeDescription`	String	Provider description for the SIC code.	Can be absent.
`NAICSs.NAICS`	Array	NAICS codes and descriptions.	Can be empty or absent.
`NAICS`	String	North American Industry Classification System code returned by LexisNexis.	Can be absent within an incomplete record.
`NAICSDescription`	String	Provider description for the NAICS code.	Can be absent.

Stored Report request

Attribute	Type	Meaning	Null or optional behavior
`TopBusinessReportRequest.Options.IncludeIndustries`	Number	`1` requests the industry section.	Omitted when the option is not selected.
`TopBusinessReportRequest.Options.BusinessReportFetchLevel`	String	Fixed fetch level `"S"` sent by Lendflow.	Always added by the current Report request builder.
`TopBusinessReportRequest.ReportBy.BusinessIds`	Object	Provider IDs selecting the report subject.	Built from stored `sele_id` or Search’s first record.
`OrgID`, `UltID`, `SeleID`	Numbers or strings	Business identifiers sent back to LexisNexis for Report.	Available keys depend on the selection path.

Provider results and Lendflow statuses

Provider result fields answer questions about the matched business. Lendflow statuses answer whether the asynchronous integration ran and stored a response.

Provider result fields

Field or result	Meaning
`Header.Status: 0`	Status used in Lendflow’s successful provider fixtures. The complete status-code catalog is available only in credentialed LexisNexis documentation.
`RecordCount: 0`	Search completed without a matching record; Lendflow converts this to `No search results found.`.
`IsActive`, `IsDefunct`, or `TINInfoMatch`	Business-level provider indicators. A `false` value is a valid result and does not mean the integration failed.
Empty or absent report section	The section was not selected, was not entitled, or had no provider data. Check the stored request options before interpreting it.

Lendflow lifecycle statuses and errors

Lendflow status or error	Meaning	Action
`Not yet started`	The operation has not started.	Run the applicable service.
`Started`	The asynchronous job is running.	Continue polling.
`Success`	Lendflow stored the provider response.	Interpret provider result fields and returned sections.
`No search results found.`	Search returned `RecordCount: 0`.	Verify the business identity inputs before rerunning. Report cannot proceed without identifiers.
`Unauthenticated.` or `Authorization failed.`	Provider authentication failed.	Verify service access and configured credentials.
`Invalid options for lexis_nexis_kyb_report`	The underwriting API received an unsupported Report option.	Send only the 28 exact option keys listed above.
`The selected lexis_nexis_kyb_options.0 is invalid.`	The v1 business-credit wrapper received an unsupported option.	Correct the invalid array value.
`The service did not respond within a reasonable time. Try again later.`	The provider request timed out.	Retry later.
`Something went wrong while processing the request.`	The provider or integration failed without a more specific message.	Retry, then contact Lendflow if the error continues.

See Data Provider Status Messages for shared status guidance.

FAQ

What is the difference between Search and Report?

Search returns possible business matches and their LexisNexis identifiers. Report uses one set of identifiers to retrieve the selected report sections. They are separate services with separate statuses and responses.

Does Report run Search automatically?

Yes. If the business does not already have stored LexisNexis top-business identifiers, Lendflow runs Search before Report. If Search returns no records, Report cannot continue.

Which Search result does Report use?

Lendflow uses the business’s stored sele_id when present. Otherwise, it uses the complete BusinessIds object from the first Search record.

Which Report option is used by default?

If Report options are omitted or empty, the backend uses IncludeIndustries. The Dashboard’s manual run requires the user to select one or more options, while Run with all models selects all 28.

Why is a selected Report section absent?

A selected option requests a section but does not guarantee records. The section can be absent or empty because of account entitlement, source coverage, or no data for the selected business.

Does Success mean the business is active or verified?

No. Success means Lendflow stored the provider response. Read IsActive, IsDefunct, match indicators, and the requested report sections to interpret the business result.

Are the detailed provider fields publicly documented?

Not completely. LexisNexis’s public materials confirm the product’s broader business-record and linking capabilities, but the detailed TopBusinessSearch and TopBusinessReport schemas require product access. The response shape on this page is fixture-confirmed against Lendflow’s current integration.

Does a queued or executed response mean LexisNexis finished?

No. data.onqueue: true and data.executed: true acknowledge scheduling. Poll the applicable enrichment or Data Orchestration status until processing reaches a terminal state.

​LexisNexis KYB

​Operations

​Requirements

​Search

​Report

​Search-to-Report business selection

​Report options

​Defaults and API names

​Run through the application enrichment API

​Run with Data Orchestration

​What the service returns

​Representative response

​Response attributes

​Lendflow wrapper

​Provider Search response

​Provider Report response

​Stored Report request

​Provider results and Lendflow statuses

​Provider result fields

​Lendflow lifecycle statuses and errors

​FAQ

LexisNexis KYB

Operations

Requirements

Search

Report

Search-to-Report business selection

Report options

Defaults and API names

Run through the application enrichment API

Run with Data Orchestration

What the service returns

Representative response

Response attributes

Lendflow wrapper

Provider Search response

Provider Report response

Stored Report request

Provider results and Lendflow statuses

Provider result fields

Lendflow lifecycle statuses and errors

FAQ