---
title: "Business Search"
method: POST
path: "/v3/business/search"
tags: ["Business Search"]
---

# Business Search

`POST /v3/business/search`

Calling this method will perform a business search.

## Request body

- BusinessSearchRequest
  - `Test` boolean
  - `SearchType` 'Demo', required — The type of search to perform. Please use 'Demo' to try it.
  - `PackageId` string, required — The Package ID to run the transaction under which can be obtained by your Customer Success Manager or via a support ticket.
  - `CallBackUrl` string, nullable
  - `Timeout` integer, nullable — 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` string[], nullable — Some datasources required your customer provide consent to access them. Set that the customer has provided consent for each datasource that requires one. If consent is not provided the datasource will not be queried.
  - `Business` BusinessSearchRequestBusinessSearchModel — Business Object
    - `BusinessName` string, nullable — Name of the business to be verified
    - `Website` string, nullable — Website of the business
    - `JurisdictionOfIncorporation` string, nullable — Jurisdiction Of Incorporation of the business to be verified
    - `dunsNumber` string, nullable — DUNS number of the business to be verified
    - `Location` Location
      - `BuildingNumber` string, nullable — House / Civic / Building number of home address
      - `BuildingName` string, nullable — Name of building of home address
      - `UnitNumber` string, nullable — Flat/Unit/Apartment number of home address
      - `StreetName` string, nullable — Street name of primary residence
      - `StreetType` string, nullable — Street type of primary residence (e.g. St, Rd etc)
      - `City` string, nullable — City of home address
      - `Suburb` string, nullable — Suburb / Subdivision / Municipality of home address
      - `County` string, nullable — County / District of home address
      - `StateProvinceCode` string, nullable — State of primary residence. US sources expect 2 characters. Australian sources expect 2 or 3 characters.
      - `Country` string, nullable — Country of physical address (ISO 3166-1 alpha-2)
      - `PostalCode` string, nullable — ZIP Code or Postal Code of home address
      - `poBox` string, nullable — Post Office Box
      - `AdditionalFields` LocationAdditionalFields — Additional Fields for Location
        - `Address1` string, nullable — 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). GlobalGateway will provide a pass through of Address1 directly to connected datasources for the selected country. Please 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.
  - `CountryCode` string, required — The country code for which the verification needs to be performed.

## Response `200`

Success

- BusinessSearchResponse
  - `transactionID` string, nullable — The id for the transaction it will be a GUID
  - `UploadedDt` string, date-time — Time in UTC
  - `CountryCode` string, nullable — The country code for which the verification was performed.
  - `ProductName` string, nullable — Product Name
  - `Record` BusinessRecord
    - `TransactionRecordID` string, nullable — The TransactionRecordID, this is the ID you will use to fetch the transaction again.
    - `RecordStatus` string, nullable — 'match' or 'nomatch' if the verification passed the rules configured on your account this will be 'match'.
    - `DatasourceResults` BusinessResult[], nullable — Results for each datasource that was queried
      - `results` Result[], nullable
        - `Index` string, nullable
        - `BusinessName` string, nullable
        - `MatchingScore` string, nullable
        - `BusinessRegistrationNumber` string, nullable
        - `dunsNumber` string, nullable
        - `BusinessTaxIDNumber` string, nullable
        - `BusinessLicenseNumber` string, nullable
        - `JurisdictionOfIncorporation` string, nullable
        - `FullAddress` string, nullable
        - `BusinessStatus` string, nullable — Business Status
        - `OriginalBusinessStatus` string, nullable — Original Business Status
        - `TradeStyleName` string, nullable — Trade Style Name
        - `BusinessType` string, nullable — Business Type
        - `Address` Address
          - `fullAddress` string
          - `addressLine1` string
          - `addressLine2` string
          - `city` string
          - `stateProvince` string
          - `country` string
          - `zipCode` string
        - `OtherBusinessNames` string[], nullable
        - `Website` string, nullable
        - `Telephone` string, nullable
        - `TaxIDNumber` string, nullable
        - `TaxIDNumbers` string[], nullable
        - `EmailAddress` string, nullable
        - `WebDomain` string, nullable
        - `WebDomains` string[], nullable
        - `Naics` BusinessSearchResponseIndustryCode[], nullable — North American Industry Classification System
          - `Code` string, nullable
          - `Description` string, nullable
        - `Sic` BusinessSearchResponseIndustryCode[], nullable — Standard Industrial Classification
          - `Code` string, nullable
          - `Description` string, nullable
      - `DatasourceName` string, nullable
      - `Errors` ServiceError[], nullable
        - `Code` string, nullable
        - `Message` string, nullable
    - `Errors` ServiceError[], nullable
      - `Code` string, nullable
      - `Message` string, nullable
  - `Errors` ServiceError[], nullable — Collection of record errors
    - `Code` string, nullable
    - `Message` string, nullable

## Other responses

- `400` — Your request could not be processed, there should be more details in the response.
- `401` — The user name and password you provided is not valid or you are using an account not configured to be an API user.
- `408` — The request took longer to process than we waited.
- `415` — You asked for a media type that we do not support. You should request application/json in the Content-Type header.
- `500` — An error happened on the server without a specific message.

---

[API](https://skmtc.net/trulioo/apis/trulioo-platform-api.md) · [All operations](https://skmtc.net/trulioo/apis/trulioo-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trulioo/trulioo-platform-api/revisions/a825565ee177/schema)