| Field | Description |
| BusinessEntityLastUpdatedDate | Date the ABN details were last updated. Displayed as yyyy-mm-dd |
| AbnCount | Number of ABNs associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional ABNs otherwise only the 1st is returned. |
| AbnItemNumber | ABN item number where count is greater than zero. |
| AbnIdentifierValue | Entity's ABN, E.g. 48123123124 (11 digits) |
| AbnIdentifierStatus | An ABN can have a status of active or cancelled. A status of cancelled means the business has ceased trading. |
| AbnIsCurrentIndicator | Indicates whether the ABN is current i.e. has not been replaced with another ABN. |
| AbnReplacedIdentifierValue | Any ABN that the entity has replaced - usually blank. E.g. 61814236264 (11 digits) |
| AbnReplacedFrom | If an ABN is replaced, the date it was replaced. This is the same date for all ABNs including the current one. You will be unable to determine which order the ABNs were issued in – you can only determine the current one. Displayed as yyyy-mm-dd |
| EntityStatusCount | Number of Entity Statuses associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional Entity Statuses otherwise only the 1st is returned. |
| EntityStatusItemNumber | Entity Status item number where count is greater than zero. |
| EntityStatusCode | ABN status is either active or cancelled. |
| EntityEffectiveFrom | Date of effect of the ABN status. Displayed as yyyy-mm-dd |
| EntityEffectiveTo | Date the status ceases to be effective. Note - 0001-01-01 is a blank date and indicates the status is currently effective. Displayed as yyyy-mm-dd |
| AsicNumber | Australian Company Number (ACN) assigned by ASIC. E.g. 123123124 (9 digits) |
| EntityTypeCode | Code that defines the entity type. Refer to Entity type code list for details https://abr.business.gov.au/Downloads/EntityTypeList.pdf |
| EntityDescription | Description of the entity type Refer to Entity type description list for details https://abr.business.gov.au/EntityTypeList.aspx |
| GoodsAndServicesTaxCount | Number of GST registrations associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional GST registrations otherwise only the 1st is returned. |
| GoodsAndServicesTaxItemNumber | GST registration item number where count is greater than zero. |
| GoodsAndServicesTaxEffectiveFrom | Date the GST registration came into effect. Displayed as yyyy-mm-dd |
| GoodsAndServicesTaxEffectiveTo | Date the GST registration ceased. Note - 0001-01-01 is a blank date and indicates GST is currently effective. Displayed as yyyy-mm-dd |
| DgrEndorsementsCount | Number of DGR endorsements associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional DGR endorsements otherwise only the 1st is returned. |
| DgrEndorsementsItemNumber | DGR endorsement item number where count is greater than zero. |
| DgrEndorsementEndorsedFrom | Date of effect of the DGR endorsement. Displayed as yyyy-mm-dd |
| DgrEndorsementEndorsedTo | Date DGR endorsement ceases to be effective. Note - 0001-01-01 is a blank date and indicates the endorsement is currently effective. Displayed as yyyy-mm-dd |
| MainNameCount | Number of Main Names associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional Main Names otherwise only the 1st is returned. |
| MainNameItemNumber | Main Name item number where count is greater than zero. |
| MainNameOrganisationName | Name that appears on all official documents or legal papers. An entity will have zero or 1 current mainName. |
| MainNameEffectiveFrom | Date of effect of the name. Displayed as yyyy-mm-dd |
| MainNameEffectiveTo | Date the name ceases to be effective. Note - 0001-01-01 is a blank date and indicates the name is currently effective. Displayed as yyyy-mm-dd |
| MainBusinessPhysicalAddressCount | Number of Main Business Physical Addresses associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional addresses otherwise only the 1st is returned. |
| MainBusinessPhysicalAddressItemNumber | Main Business Physical Address item number where count is greater than zero. |
| MainBusinessPhysicalAddressStateCode | State/territory component of address. |
| MainBusinessPhysicalAddressPostcode | The postcode component of the address. E.g. 2601 but also includes international postcodes e.g. NW51AG. |
| MainBusinessPhysicalAddressIsCurrentIndicator | Indicates if address is current – always true. |
| MainBusinessPhysicalAddressEffectiveFrom | Date of effect of the address. Displayed as yyyy-mm-dd |
| MainBusinessPhysicalAddressEffectiveTo | Date address ceases to be effective. Note - 0001-01-01 is a blank date and indicates the endorsement is currently effective. Displayed as yyyy-mm-dd |
| LegalNameCount | Number of Legal Names associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional Legal Names otherwise only the 1st is returned. |
| LegalNameItemNumber | Legal Name item number where count is greater than zero. |
| LegalNameGivenName | Given name associated with an individual. E.g. Clinton |
| LegalNameOtherGivenName | Other given name or initial associated with an individual. E.g. W or William |
| LegalNameFamilyName | Family name associated with an individual. E.g. Newbee |
| LegalNameFullName | Full Name name associated with an individual. E.g. Clinton Newbee |
| MainTradingNameCount | Number of Main Trading Names associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional Main Trading Names otherwise only the 1st is returned. |
| MainTradingNameItemNumber | Main Trading Name item number where count is greater than zero. |
| MainTradingNameOrganisationName | Name that appears on all official documents or legal papers. An entity will have zero or 1 current mainName. |
| MainTradingNameEffectiveFrom | Date of effect of the name. Displayed as yyyy-mm-dd |
| MainTradingNameEffectiveTo | Date the name ceases to be effective. Note - 0001-01-01 is a blank date and indicates the name is currently effective. Displayed as yyyy-mm-dd |
| BusinessNameCount | Number of Business Names associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional Business Names otherwise only the 1st is returned. |
| BusinessNameItemNumber | Business Name item number where count is greater than zero. |
| BusinessNameOrganisationName | Registered business name(s). An entity may have zero or more registered business name. |
| BusinessNameEffectiveFrom | Date of effect of the name. Displayed as yyyy-mm-dd |
| BusinessNameEffectiveTo | Date the name ceases to be effective. Note - 0001-01-01 is a blank date and indicates the name is currently effective. Displayed as yyyy-mm-dd |
| OtherTradingNameCount | Number of Other Trading Names associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional Other Trading Names otherwise only the 1st is returned. |
| OtherTradingNameItemNumber | Other Trading Name item number where count is greater than zero. Displayed as yyyy-mm-dd |
| OtherTradingNameOrganisationName | Other trading names also used. |
| OtherTradingNameEffectiveFrom | Date of effect of the name. Displayed as yyyy-mm-dd |
| OtherTradingNameEffectiveTo | Date the name ceases to be effective. Note - 0001-01-01 is a blank date and indicates the name is currently effective. Displayed as yyyy-mm-dd |
| CharityTypeCount | Number of Charity Types associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional Charity Types otherwise only the 1st is returned. |
| CharityTypeItemNumber | Charity Type item number where count is greater than zero. |
| CharityTypeDescription | Charity type description. E.g. Charitable Institution |
| CharityTypeEffectiveFrom | Date of effect of the charity type. Displayed as yyyy-mm-dd |
| CharityTypeEffectiveTo | Date the charity type ceases to be effective. Note - 0001-01-01 is a blank date and indicates the charity type is currently effective. Displayed as yyyy-mm-dd |
| TaxConcessionCharityEndorsementCount | Number of Tax Concession Charity Endorsements associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional Tax Concession Charity Endorsements otherwise only the 1st is returned. |
| TaxConcessionCharityEndorsementItemNumber | Tax Concession Charity Endorsement item number where count is greater than zero. |
| TaxConcessionCharityEndorsementType | Charity tax concession description. E.g. GST Concession |
| TaxConcessionCharityEndorsementEffectiveFrom | Date of effect of the concession. Displayed as yyyy-mm-dd |
| TaxConcessionCharityEndorsementEffectiveTo | Date the concession ceases to be effective. Note - 0001-01-01 is a blank date and indicates the concession is currently effective. Displayed as yyyy-mm-dd |
| DgrFundCount | Number of DGR Funds associated with the business entity. Set the DisplayExtendedResults parameter to ‘Y’ to display additional DGR Funds otherwise only the 1st is returned. |
| DgrFundItemNumber | DGR Fund item number where count is greater than zero. |
| DgrFundOrganisationName | Name of the DGR (Deductible Gift Recipient) fund. |
| DgrFundIsCurrentIndicator | Indicates if DGR Fund is current |
| DgrFundEndorsedFrom | Date of effect of the DGR endorsement. Displayed as yyyy-mm-dd |
| DgrFundEndorsedTo | Date DGR endorsement ceases to be effective. Note - 0001-01-01 is a blank date and indicates the endorsement is currently effective. Displayed as yyyy-mm-dd |
Web Service Method: ProcessQueryStringRequest (REST)
Request Format: Url QueryString,
Protocols: HTTP GET, HTTPS GET,
Response Formats: JSON, XML*
Example Server Path: https://customname.datatoolscloud.net.au/KleberWebService/DtKleberService.svc
Sample QueryString Request:
/ProcessQueryStringRequest?Method=DataTools.Verify.AustralianBusinessNumber.AuAbr.VerifyAbn&ABN=&IncludeHistoricalDetails=&AuthenticationGuid=&DisplayExtendedResults=&RequestId=&RequestKey=&DepartmentCode=
Sample JSON Response:
{
"DtResponse":{
"RequestId":"",
"ResultCount":"1",
"ErrorMessage":"",
"Result":[
{
"BusinessEntityLastUpdatedDate":"",
"AbnCount":"",
"AbnItemNumber":"",
"AbnIdentifierValue":"",
"AbnIdentifierStatus":"",
"AbnIsCurrentIndicator":"",
"AbnReplacedIdentifierValue":"",
"AbnReplacedFrom":"",
"EntityStatusCount":"",
"EntityStatusItemNumber":"",
"EntityStatusCode":"",
"EntityEffectiveFrom":"",
"EntityEffectiveTo":"",
"AsicNumber":"",
"EntityTypeCode":"",
"EntityDescription":"",
"GoodsAndServicesTaxCount":"",
"GoodsAndServicesTaxItemNumber":"",
"GoodsAndServicesTaxEffectiveFrom":"",
"GoodsAndServicesTaxEffectiveTo":"",
"DgrEndorsementsCount":"",
"DgrEndorsementsItemNumber":"",
"DgrEndorsementEndorsedFrom":"",
"DgrEndorsementEndorsedTo":"",
"MainNameCount":"",
"MainNameItemNumber":"",
"MainNameOrganisationName":"",
"MainNameEffectiveFrom":"",
"MainNameEffectiveTo":"",
"MainBusinessPhysicalAddressCount":"",
"MainBusinessPhysicalAddressItemNumber":"",
"MainBusinessPhysicalAddressStateCode":"",
"MainBusinessPhysicalAddressPostcode":"",
"MainBusinessPhysicalAddressIsCurrentIndicator":"",
"MainBusinessPhysicalAddressEffectiveFrom":"",
"MainBusinessPhysicalAddressEffectiveTo":"",
"LegalNameCount":"",
"LegalNameItemNumber":"",
"LegalNameGivenName":"",
"LegalNameOtherGivenName":"",
"LegalNameFamilyName":"",
"LegalNameFullName":"",
"MainTradingNameCount":"",
"MainTradingNameItemNumber":"",
"MainTradingNameOrganisationName":"",
"MainTradingNameEffectiveFrom":"",
"MainTradingNameEffectiveTo":"",
"BusinessNameCount":"",
"BusinessNameItemNumber":"",
"BusinessNameOrganisationName":"",
"BusinessNameEffectiveFrom":"",
"BusinessNameEffectiveTo":"",
"OtherTradingNameCount":"",
"OtherTradingNameItemNumber":"",
"OtherTradingNameOrganisationName":"",
"OtherTradingNameEffectiveFrom":"",
"OtherTradingNameEffectiveTo":"",
"CharityTypeCount":"",
"CharityTypeItemNumber":"",
"CharityTypeDescription":"",
"CharityTypeEffectiveFrom":"",
"CharityTypeEffectiveTo":"",
"TaxConcessionCharityEndorsementCount":"",
"TaxConcessionCharityEndorsementItemNumber":"",
"TaxConcessionCharityEndorsementType":"",
"TaxConcessionCharityEndorsementEffectiveFrom":"",
"TaxConcessionCharityEndorsementEffectiveTo":"",
"DgrFundCount":"",
"DgrFundItemNumber":"",
"DgrFundOrganisationName":"",
"DgrFundIsCurrentIndicator":"",
"DgrFundEndorsedFrom":"",
"DgrFundEndorsedTo":""
}
]
}
}
* Add the additional input parameter "OutputFormat=json" or "OutputFormat=xml" to change the response format from default.
* Add the additional input parameter "callback" to convert JSON responses to JSONP responses for across domains support.
CORS header included where callback is not defined.
Ensure you thoroughly test all the methods you are using and are happy with the results before going into production. DataTools is charged by the data suppliers for use of every method – therefore
When you register DataTools provides you with free credit to help with development and trialling of the service. Once that credit is used you will need to purchase a monthly subscription and/or top up to continue using the service, even for development purposes. Please check the Method Pricing List for all current costs. DataTools does not warrant or guarantee the quality of the results returned and will not be held responsible for any costs incurred by using a method. Should you have any questions please contact your Sales representative or the Client Services team.