> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lendflow.com/llms.txt
> Use this file to discover all available pages before exploring further.

# LexisNexis KYB

## 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](https://risk.lexisnexis.com/products/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:

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

<Warning>
  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.
</Warning>

## 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

1. Call [Enrich Business Credit Application](/api-reference/workflow-management/enrich-business-credit-application) for the application.
2. Set `provider` to `lexis_nexis_kyb_search` or `lexis_nexis_kyb_report`.
3. For Report, optionally include `options.lexisNexisKybOptions` with one or more values from the table above.
4. Include the applicable underwriting `stage_id` when required by the application's workflow.
5. Confirm that the response contains `data.onqueue: true`.
6. Poll [Get Commercial Data](/api-reference/workflow-management/get-commercial-data) with `services[]=lexis_nexis_kyb_search` and/or `services[]=lexis_nexis_kyb_report`.
7. 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](/api-docs/reference/put-api-v1-applications-business-credit-application-id-enrich). 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.

1. In the Lendflow Dashboard, open **Builders > Data Orchestration**.
2. Create or edit a template and add the applicable LexisNexis KYB operation from the **KYB** category.
3. Configure the conditions and connect each outcome, then save and publish the template. Data Orchestration uses the default **Include Industries** Report option.
4. Call [Execute Data Orchestration](/api-reference/data-orchestration/execute-data-orchestration) with `template_id` and `application_id`. Include `stage_id` when applicable.
5. Confirm that the response contains `data.executed: true`.
6. Monitor the asynchronous run with [List Data Orchestration Logs](/api-reference/data-orchestration/list-data-orchestration-logs) and [Get Data Orchestration Log](/api-reference/data-orchestration/get-data-orchestration-log).
7. 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.

```json theme={"system"}
{
  "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](/api-docs/docs/error-handling-external-data-provider-status-messages) for shared status guidance.

## FAQ

<AccordionGroup>
  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>

  <Accordion title="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.
  </Accordion>
</AccordionGroup>