GET
/
validate
/
{identifier}
Check the format and check digit of an ABN or ACN.
curl --request GET \
  --url https://api.auo.com.au/v1/validate/{identifier} \
  --header 'Authorization: Bearer <token>'
{
  "input": "<string>",
  "normalized": "<string>",
  "valid": true
}
GET https://api.auo.com.au/v1/validate/{identifier} Validate the check digit of an ABN or ACN. This is a pure, offline check: it does not look the identifier up in any register, so it is fast and cheap. Use it to catch typos before you resolve.

​
Request

​
identifier
string
required
A 9-digit ACN or an 11-digit ABN. Non-digit input, or any length other than 9 or 11, returns a 400.

​
Response

​
identifier_type
string
abn or acn, inferred from the length.
​
input
string
The identifier you sent.
​
normalized
string
The identifier with spaces removed.
​
valid
boolean
Whether the check digit is valid. A 200 with valid: false means the identifier is well-formed but its check digit does not compute. It is not an error.

​
Example

curl https://api.auo.com.au/v1/validate/51824753556 \
  -H "Authorization: Bearer auo_sk_test_your_key"
Response
{
  "identifier_type": "abn",
  "input": "51824753556",
  "normalized": "51824753556",
  "valid": true
}
Validating an identifier before resolving saves a round trip on obvious typos, but it is optional. /resolve accepts any identifier and returns an empty result for one it cannot find.

Authorizations

​
Authorization
string
header
required

Bearer token: auo_sk_test_... (sandbox) or auo_sk_live_... (live).

Path Parameters

​
identifier
string
required

An 11-digit ABN or 9-digit ACN (spaces are stripped before validation).

Response

Validation result. valid:false means an invalid check digit, not an error.

​
identifier_type
enum<string>
required

Whether the identifier was treated as an ABN (11 digits) or ACN (9 digits).

Available options:
abn,
acn
​
input
string
required

The raw identifier string as supplied in the request path.

​
normalized
string
required

The identifier with whitespace stripped.

​
valid
boolean
required

True if the check digit is correct; false otherwise.

​
reason
enum<string>

Present only when valid is false. "format" means the digit count or character set is wrong; "checksum" means the check digit does not match.

Available options:
format,
checksum