Business Number Validation

The Australian Business Number (ABN) validation endpoint provides comprehensive validation of ABNs according to Australian Taxation Office (ATO) standards. This service validates the structure and format of ABNs, ensuring they meet the required mathematical validation rules and checksums. The validation includes checking for valid number length and performing weighted sum calculations to verify the number's authenticity.

ABN validation helps ensure data quality by confirming the structural validity of business numbers before they are used in taxation and regulatory systems. The service supports the standard 11-digit ABN format, making it suitable for validating all Australian Business Numbers.

IMPORTANT

This validation performs ONLY mathematical pattern conformity checks against ATO-defined formats and does not verify the actual registration or status of the ABN with the Australian Business Register. A successful validation only confirms that the ABN follows the correct structure and passes the checksum algorithm.

A "valid" result should NOT be interpreted as confirmation that the ABN is currently registered, active, or assigned to any business. For systems requiring guaranteed validity, additional verification steps can be implemented via Business Number API →

Model

Specific structure of the data that represents the entity within the API. It defines the attributes and their data types associated with the entity.

It's important to note that you'll need to retrieve the complete identifier for an entity each time you require its complete model. This can be achieved by utilizing the find endpoint to locate the entity and then using the retrieved identifier to call the retrieve endpoint for complete model.

  • Name
    number
    Type
    string
  • Name
    formatted
    Type
    string
  • Name
    isValid
    Type
    boolean
GET/validate/business-number/

Validate

This endpoint analyzes an Australian Business Number to verify its validity according to ATO standards. It performs checks including:

  • Valid length (11 digits)
  • Correct weighted sum calculation
  • Proper checksum validation
  • Structural compliance with ABN format rules

Mandatory headers

  • Name
    x-api-key
    Type
    string
    Description
    A valid API key obtained through active subscription must be included in the header in order for the endpoint to work.

Required parameters

  • Name
    number
    Type
    string
    Description
    The Business Number (ABN) to validate.

Request

GET
/validate/business-number/
curl "https://api.vigil.sh/validate/business-number/?number=51824753556" \
-H 'x-api-key: {api-key}'

Response

{
  "result": {
  "number": "51824753556",
    "formatted": "51 824 753 556",
    "isValid": true
  }
}