Australian Business Number (ABN) check API
Check an 11-digit Australian Business Number with the Australian Business Register's modulus 89 rule.
POST https://api.curatedapi.com/v1/calc/check/abn
- Version 1
- MCP tool
calc_check_abn - Try it in the browser
Checks an Australian Business Number the way the Australian Business Register describes: subtract 1 from the first digit, multiply the eleven digits by the weights 10, 1, 3, 5, 7, 9, 11, 13, 15, 17 and 19, and the total must divide by 89.
Formula
((d₁ − 1)·10 + d₂·1 + d₃·3 + d₄·5 + … + d₁₁·19) mod 89 = 0
- The number is checked by arithmetic alone. Nothing is looked up, so a valid result means the number is well formed, not that the account, company or security exists.
Inputs
Send numbers as strings to keep every digit. options sets precision and rounding (see numbers and rounding).
| Input | Type | Description |
|---|---|---|
number required |
string | The 11-digit ABN. Spaces, dots, hyphens and slashes are ignored, and lower-case letters are read as upper case. At most 64 characters. |
Result
Under result in the answer, next to exactness, precision, inputs, formula, references and warnings.
| Result | Type | Description |
|---|---|---|
valid | boolean | Whether the ABN passes every check. |
normalized | string | The number as it was checked: separators removed, letters in upper case. |
problem | string | What is wrong, when valid is false: CHARACTERS: a character that cannot appear in this kind of number; LENGTH: the wrong number of characters; COUNTRY: an unknown or unsupported country code; FORMAT: the right length but the wrong structure; CHECK_DIGIT: the check digit or check characters do not match the rest of the number. |
message | string | The result in a sentence, naming the rule that failed. |
formatted | string | The ABN grouped 2-3-3-3. |
Examples
The Australian Business Register's own example
curl https://api.curatedapi.com/v1/calc/check/abn \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"number": "51 824 753 556"
}'
{
"calculator": "check/abn@1",
"result": {
"valid": true,
"normalized": "51824753556",
"message": "A well-formed ABN.",
"formatted": "51 824 753 556"
},
"exactness": {},
"precision": null,
"inputs": {
"number": "51 824 753 556"
},
"formula": "((d₁ − 1)·10 + d₂·1 + d₃·3 + d₄·5 + … + d₁₁·19) mod 89 = 0",
"references": [
{
"title": "Australian Business Register: format of the ABN",
"url": "https://abr.business.gov.au/Help/AbnFormat"
}
],
"warnings": []
}
One digit wrong
curl https://api.curatedapi.com/v1/calc/check/abn \
-H "Authorization: Bearer $CURATEDAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"number": "51 824 753 557"
}'
{
"calculator": "check/abn@1",
"result": {
"valid": false,
"normalized": "51824753557",
"problem": "CHECK_DIGIT",
"message": "The digits do not pass the Australian Business Register's modulus 89 check.",
"formatted": "51 824 753 557"
},
"exactness": {},
"precision": null,
"inputs": {
"number": "51 824 753 557"
},
"formula": "((d₁ − 1)·10 + d₂·1 + d₃·3 + d₄·5 + … + d₁₁·19) mod 89 = 0",
"references": [
{
"title": "Australian Business Register: format of the ABN",
"url": "https://abr.business.gov.au/Help/AbnFormat"
}
],
"warnings": []
}
References
Results follow each calculator's documented rules and the sources listed. They are not financial, tax or legal advice. Check that the rules fit your case before you rely on a result. See the terms.
Errors share one format; see errors. Billing, retries and batches work the same for every endpoint.