---
title: "Verify"
method: POST
path: "/v3/business/verify"
tags: ["Business Verification"]
---

# Verify

`POST /v3/business/verify`

Calling this method will perform a Business Verification.

## Request body

- BusinessVerifyRequest — The business verification call for the Normalized API is a POST method call
  - `VerificationType` 'Demo', required — The type of verification to perform. Please use 'Demo' to try it.
  - `PackageId` string, required — The Package ID to run the transaction under
  - `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.
  - `CountryCode` string, required — The country code for which the verification needs to be performed.
  - `CustomerReferenceID` string, nullable — Customer Reference Id
  - `BusinessDataFields` BusinessDataFields, required — The data field name-value pairs for the data elements on which the verification is to be performed
    - `BusinessName` string, nullable — Name of the business to be verified
    - `TradestyleName` string, nullable — Trade Style Name of the business to be verified
    - `TaxIDNumber` string, nullable — Tax ID Number of the business to be verified
    - `BusinessRegistrationNumber` string, nullable — Registration number of business to be verified
    - `DayOfIncorporation` integer, nullable — Day of incorporation of the business to be verified
    - `MonthOfIncorporation` integer, nullable — Month of incorporation of the business to be verified
    - `YearOfIncorporation` integer, nullable — Year of incorporation of the business to be verified
    - `JurisdictionOfIncorporation` string, nullable — Jurisdiction Of Incorporation of the business to be verified
    - `ShareholderListDocument` boolean, nullable — Whether or not to retrieve shareholderList document
    - `FinancialInformationDocument` boolean, nullable — Whether or not to retrieve financial information document
    - `EnhancedProfile` boolean, nullable — Whether or not to retrieve enhanced profile
    - `DunsNumber` string, nullable — Duns Number
    - `Entities` boolean, nullable — Whether or not to retrieve entity detail
    - `PeopleOfSignificantControl` PersonOfSignificantControl[], nullable — A list of people to check for their matchstatus
      - `FirstGivenName` string, nullable
      - `MiddleName` string, nullable
      - `FirstSurname` string, nullable
      - `SecondSurname` string, nullable
      - `FullName` string, nullable
      - `BusinessName` string, nullable
    - `Filings` boolean, nullable — Whether or not to retrieve filing detail
    - `ArticleOfAssociation` boolean, nullable — Whether or not to retrieve article of association document
    - `RegistrationDetails` boolean, nullable — Whether or not to retrieve registration detail document
    - `AnnualReport` boolean, nullable — Whether or not to retrieve annual report document
    - `Telephone` string, nullable — Telephone number of the business to be verified
    - `TestEntityName` string, nullable — TestEntity Name
    - `CountrySpecific` object, nullable — CountrySpecific fields {"CountryCode" : {"Field1" : "Value", "Field2" : "Value" }}
    - `Location` BusinessLocation[], nullable — Location Information
      - `Index` integer, nullable — The index in the list of locations. Currently only 1 and 2 are valid if in a collection of more than 1
      - `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
      - `Address1` string, nullable — A non-segmented version of the first line of the address
  - `VerboseMode` boolean — To return additional appended fields of watch list hit details in the response

## Response `200`

Success

- BusinessResult
  - `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

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