Loqate Harmony Documentation
  • GBG Loqate AU & NZ
  • Loqate Harmony API
    • Sign up for free trial
    • Login
    • API Specification
      • Authentication
      • Address
        • Address Validation & Lookup
        • Address by Geocode
        • Address Cleanse
        • Address Parse
        • Geocode Intl
      • Address Insights
        • Australian Insights
          • SEIFA Australia
          • ASGS Australia Statistical Geography Standard
          • Residential / Commercial
          • Deliverable address
      • Suburb Lookup
      • Business Validation and Lookup
      • Email Validation
      • Phone Validation
      • Matching
      • Moved Suppression
      • Deceased Suppression
      • Objects
        • Address Objects
        • Address Type Objects
        • Suburb Objects
        • Parse Objects
        • Email Objects
        • Phone Objects
        • Property Title Objects
        • Match Objects
        • Business Objects
      • Deprecated API services
        • Email Validation v1.1
        • Address v1
        • Address Cleanse v1
        • Address International
        • Address Combined
        • Address Types
    • Guides
      • Best Practices
        • Address Field Mappings
        • Finding an Address
      • User Derived Address
      • Expanded sub-premise reach
      • Parcel Locker Plus
      • Migrating to Address V2
      • Sign up/ Login
      • Support
      • Console
        • Getting your API keys
        • Getting Started
        • Add a Service
        • Dashboard
        • Subscriptions
          • Features
          • Users
          • Subscribed Plans
          • Allowlisting domains
          • Blocklist - Email Validation
        • Reports
        • Invoices
          • Paying Invoices
      • API Latency
    • Demos
      • How to use our demos
      • Address Validation Demo
      • Address by Geocode (Reverse Geocode) Demo
      • Address Cleanse Demo
      • Address Parse Demo
      • Business Validation Demo
      • Email Validation Demo
      • Phone Validation demo
    • Integrations
      • Client Libraries
        • Javascript Library v2.1.0
      • Adobe Commerce (Magento 2) Plugin
        • Magento2 User Guide
      • Woocommerce Plugin
        • Woocommerce Install Guide v2.0.0
        • Woocommerce Settings guide v2.0.0
      • Shopify Plus App
      • Gravity Forms
      • Voxco Survey Software
      • Salesforce CRM
      • Dynamics 365 CRM
      • Batch App - Lightweight
      • Deprecated Integrations
        • Harmony RightAddress c# example
        • Harmony RightAddress cURL example
        • Deprecated JS Library v2.0.1
        • Deprecated JQuery Library v1.8.1
    • Coverage
    • Address Exchange (Beta)
      • ADX Console
        • Searching Addresses in console
        • Create Address in console
        • Create Actions in console
      • ADX API Specification
        • Create Address
        • Get Address
        • Create Address Event
        • Edit Address Event
        • Create/Edit Address Attributes
        • Create/Edit Address Geopoint
        • Get Source Events
      • Reserved Attributes
    • GBG Status
  • Batch / Bulk Data Services
    • Serviced Batch
      • Bulk Address Cleanse
      • Email Serviced Batch
      • Phone Serviced Batch
      • Business Serviced Batch
  • Harmony Suite
    • Harmony Suite Overview
    • Release Notes
      • Version 3.0.0
        • New Features
        • Enhancements
        • Bug Fixes
        • Supported Platforms
    • User Guides
      • Version 3.0.0
        • Welcome to Harmony Suite
        • Glossary of terms
        • Upgrades
          • HSQL Upgrade
        • Email and Phone Validation
          • Prerequisites
          • Phone and Email PDP Configuration Setup
          • Phone Validation using Harmony Batch System
          • Phone Validation using Harmony WS
          • Email Validation using Harmony Batch
          • Email Validation using Harmony WS
          • Guides
            • Understanding Phone Data
            • Understanding Email Data
        • Business Lookup and Validation
          • Prerequisites
          • Business Lookup
          • Business Validation
            • Business Validation using Commercial Name Parser
            • Business Validation Configurations
            • Business Validation using Harmony Batch System
            • Business Validation using Harmony WS
          • Business data update guide
          • Guides
            • Understanding Business Data
            • Understanding Business Verification Code
            • Name Parse Ambiguity
        • Australia Post Parcel Locker Plus Lookup and Validation
          • Prerequisites
          • Australia Post Parcel Locker Plus Lookup
          • Australia Post Parcel Locker Plus Validation
            • PDP Configuration Setup
            • AupostValidation using Harmony Batch System
            • AupostValidation using Harmony WS
          • Guides
            • Knowledgebase Lexical Update
            • Understanding Australia Post Parcel Locker Plus Data
            • Interchangeable terms for Australia Post Parcel Lockers
        • Installation and Upgrade Reference Guide
        • Locate Reference Guide
        • Extensions Reference Guide
        • RealTime Reference Guide
        • Postmaster Reference Guide
        • Rapid Address ANZ Reference Guide
        • Post ANZ Reference Guide
        • Source of Truth Installation Reference Guide
        • Knowledgebase Configuration Reference Guide
        • Web Services Reference Guide
        • Management Console Reference Guide
        • Batch System Match Reference Guide
        • Batch System Cleanse Reference Guide
  • More from GBG
    • GBG GreenID
    • GBG Identity
    • GBG Fraud & Compliance
Powered by GitBook
On this page
  1. Harmony Suite
  2. User Guides
  3. Version 3.0.0
  4. Business Lookup and Validation
  5. Guides

Understanding Business Data

PreviousGuidesNextUnderstanding Business Verification Code

Last updated 1 year ago

Understanding Enriched CustomAttributes of Business

This section includes all the enriched custom attributes returned by Business Validation PDP's.

Please note that Custom attributes are available exclusively for successful business validation matches. In cases where there is no match or ambiguity, only the business_ver_code will be shown.

business_name

Main/Legal name of the business entity.

Reliability indicator of validated business.

business_country

Country ISO2 code. (e.g. AU/NZ)

businsess_bn

Business number of the entity.

business_postcode

Postcode of the business entity.

business_state

State of the business entity.

business_name_entity_type

Type of the name of the entity. MN → Main Entity Name; LGL → legal Entity Name.

business_other_entities

One business can have a list of other business entities like other trading name, other business names etc.

  • entity_name: The name of the business entity.

  • entity_type: Denotes the type of entity, categorized as follows: TRD for trading name, BN for business name, OTN for other name, and DGR for DGR name."

business_last_updated_date

The last updated date.

business_bn_status

Status of the business number. ACT -> Active, CAN -> Cancelled.

business_bn_status_from_date

Date of the business number from

business_entity_type_ind

Indicator of the entity type with description the business_entity_type_text field.

business_entity_type_text

Description for the business_entity_type_ind value.

business_tax_status

The status of the GST. ACT -> Active, CAN -> Cancelled, NON -> None.

business_tax_status_from_date

The date for the business_tax_status value. If business_tax_status is NON, date value is 19000101.

business_registration_date

business_detailed_bn_status

business_month_in_business

business_shareholding

CustomAttributes for Australian Business
"customAttributes":
{
  "business_name": "ANDREA CONE",
  "business_tax_status_from_date": "19000101",
  "business_display_name": "ANDREA CONE Trading As Andrea Cone Farran",
  "business_ver_code": "TradingName_1_0.5",
  "business_name_entity_type": "LGL",
  "business_bn": "61280082595",
  "business_entity_type_ind": "IND",
  "business_postcode": "3004",
  "business_bn_status_from_date": "20080909",
  "business_entity_type_text": "Individual/Sole Trader",
  "business_country": "au",
  "business_month_in_business": "184",
  "business_last_updated_date": "20100510",
  "business_other_entities": "[{\"entity_name\":\"Andrea Cone Farran\",\"entity_type\":\"TRD\"}]",
  "business_bn_status": "ACT",
  "business_tax_status": "NON",
  "business_state": "VIC"
}
CustomAttributes for New_Zealand Business
"customAttributes":
{
  "business_name": "R & L PILGRIM LIMITED",
  "business_display_name": "R & L PILGRIM LIMITED Trading As The Pin Tin",
  "business_ver_code": "TradingName_1_1.0",
  "business_bn_start_date": "2014-03-03T17:06:31",
  "business_name_entity_type": "MN",
  "business_cn_type": "LTD",
  "business_bn": "9429041121481",
  "business_cn": "4979800",
  "business_entity_type_ind": "LTD",
  "business_postcode": "7930",
  "business_shareholding": "[{\"numberOfShares\":\"1000\",\"shareAllocation\":[{\"allocation\":\"500\",\"shareholder\":[{\"appointmentDate\":\"2014-03-03T17:06:31\",\"individualShareholder\":[{\"firstName\":\"Reon\",\"fullName\":\"Reon David PILGRIM\",\"lastName\":\"PILGRIM\",\"middleNames\":\"David\"}],\"otherShareholder\":[],\"shareholderAddress\":[],\"type\":\"director\"}]},{\"allocation\":\"500\",\"shareholder\":[{\"appointmentDate\":\"2016-01-12T08:46:57\",\"individualShareholder\":[{\"firstName\":\"Lisa\",\"fullName\":\"Lisa Dawn PILGRIM\",\"lastName\":\"PILGRIM\",\"middleNames\":\"Dawn\"}],\"otherShareholder\":[],\"shareholderAddress\":[],\"type\":\"individual\"}]}]}]",
  "business_bn_status_from_date": "2014-03-03T17:06:31",
  "business_registration_date": "2014-03-03T17:06:31",
  "business_detailed_bn_status": "50 (Registered)",
  "business_entity_type_text": "NZ Limited Company",
  "business_country": "nz",
  "business_month_in_business": "119",
  "business_last_updated_date": "2020-10-28T13:03:50",
  "business_other_entities": "[{\"entity_name\":\"The Pin Tin\",\"entity_type\":\"TRD\"}]",
  "business_bn_status": "ACT"
}

Below are some response attributes that are specific to New_Zealand Business Validation. User can see these from samples detailed in .

business_ver_code
Sample Request and Response for New_Zealand