POST
/
resolve
Resolve an Australian entity by ABN, ACN, or name.
curl --request POST \
  --url https://api.auo.com.au/v1/resolve \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "abn": "<string>",
  "acn": "<string>",
  "name": "<string>",
  "state": "<string>",
  "postcode": "<string>"
}
'
import requests

url = "https://api.auo.com.au/v1/resolve"

payload = {
    "abn": "<string>",
    "acn": "<string>",
    "name": "<string>",
    "state": "<string>",
    "postcode": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    abn: '<string>',
    acn: '<string>',
    name: '<string>',
    state: '<string>',
    postcode: '<string>'
  })
};

fetch('https://api.auo.com.au/v1/resolve', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.auo.com.au/v1/resolve",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'abn' => '<string>',
    'acn' => '<string>',
    'name' => '<string>',
    'state' => '<string>',
    'postcode' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.auo.com.au/v1/resolve"

	payload := strings.NewReader("{\n  \"abn\": \"<string>\",\n  \"acn\": \"<string>\",\n  \"name\": \"<string>\",\n  \"state\": \"<string>\",\n  \"postcode\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.auo.com.au/v1/resolve")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"abn\": \"<string>\",\n  \"acn\": \"<string>\",\n  \"name\": \"<string>\",\n  \"state\": \"<string>\",\n  \"postcode\": \"<string>\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.auo.com.au/v1/resolve")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"abn\": \"<string>\",\n  \"acn\": \"<string>\",\n  \"name\": \"<string>\",\n  \"state\": \"<string>\",\n  \"postcode\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body
{
  "query": {},
  "candidates": [
    {
      "match_confidence": 123,
      "match_signals": {},
      "canonical": {
        "entity_form": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "abn": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "acn": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "entity_name": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "abn_status": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "gst_registered": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "entity_type": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "asic_status": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "registered_office_state": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "former_names": [
          {
            "value": "<string>",
            "source": "<string>",
            "ceased": "<string>"
          }
        ],
        "related_entities": [
          {
            "role": "corporate_trustee",
            "abn": "<string>",
            "acn": "<string>",
            "name": "<string>",
            "source": "<string>",
            "resolvable": true,
            "note": "<string>"
          }
        ],
        "icn": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "individual_name": {
          "given": "<string>",
          "other_given": "<string>",
          "family": "<string>"
        },
        "trustee_resolution": "unavailable_on_free_sources"
      },
      "conflicts": [
        {
          "field": "<string>",
          "values": [
            {
              "value": "<unknown>",
              "source": "<string>"
            }
          ]
        }
      ],
      "provenance_complete": true,
      "charity": {
        "is_registered_charity": true
      },
      "licensing": {
        "afs_licensee": {
          "licence_number": "<string>",
          "entity_name": "<string>",
          "status": "<string>",
          "start_date": "<string>",
          "end_date": "<string>",
          "register": "<string>"
        },
        "credit_licensee": {
          "licence_number": "<string>",
          "entity_name": "<string>",
          "status": "<string>",
          "start_date": "<string>",
          "end_date": "<string>",
          "register": "<string>"
        },
        "afs_authorised_rep": {
          "licence_number": "<string>",
          "entity_name": "<string>",
          "status": "<string>",
          "start_date": "<string>",
          "end_date": "<string>",
          "register": "<string>"
        },
        "credit_rep": {
          "licence_number": "<string>",
          "entity_name": "<string>",
          "status": "<string>",
          "start_date": "<string>",
          "end_date": "<string>",
          "register": "<string>"
        },
        "authorisation_links": [
          "<unknown>"
        ]
      },
      "professional_registrations": {
        "financial_adviser": {
          "registration_number": "<string>",
          "name": "<string>",
          "status": "<string>",
          "start_date": "<string>",
          "end_date": "<string>",
          "register": "<string>"
        },
        "registered_auditor": {
          "registration_number": "<string>",
          "name": "<string>",
          "status": "<string>",
          "start_date": "<string>",
          "end_date": "<string>",
          "register": "<string>"
        },
        "smsf_auditor": {
          "registration_number": "<string>",
          "name": "<string>",
          "status": "<string>",
          "start_date": "<string>",
          "end_date": "<string>",
          "register": "<string>"
        },
        "registered_liquidator": {
          "status": "not_checked",
          "note": "<string>"
        }
      },
      "external_ids": {
        "lei": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "opencorporates": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "qcc": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "spglobal": {
          "value": "<unknown>",
          "source": "<string>",
          "as_of": "<string>",
          "note": "<string>"
        },
        "_coverage": "<string>"
      },
      "screening": {
        "dfat_sanctions": {
          "checked_as_of": "<string>",
          "note": "<string>"
        },
        "asic_banned_org": {
          "matched_on": "<string>",
          "checked_as_of": "<string>",
          "note": "<string>"
        },
        "asic_banned_person": {
          "note": "<string>"
        },
        "external_administration": {
          "source": "<string>",
          "checked_as_of": "<string>",
          "note": "<string>"
        },
        "bankruptcy_petition": {
          "note": "<string>"
        },
        "austrac_reporting_entity": {
          "source": "<string>",
          "checked_as_of": "<string>",
          "note": "<string>"
        }
      }
    }
  ],
  "disclaimer": "<string>"
}
{
  "error": {
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}
{
  "error": {
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}
{
  "error": {
    "message": "<string>",
    "request_id": "<string>",
    "param": "<string>"
  }
}
POST https://api.auo.com.au/v1/resolve Resolve an Australian entity by identifier or name. Returns a ranked list of candidates, each a single canonical entity joined across every source, with provenance on every field.

​
Request

Send one of abn, acn, or name. If you send an identifier together with a name, the identifier is used and the name is ignored. Companies with no ABN are not on the Australian Business Register. Look one up by its acn and it resolves from the ASIC Companies register instead: every field carries ASIC provenance, and abn is null with a note saying no ABN is registered.
​
abn
string
An 11-digit Australian Business Number. Deterministic exact-match path.
​
acn
string
A 9-digit Australian Company Number. Deterministic exact-match path.
​
name
string
A free-text entity name. Returns a ranked, fuzzy match. A name-only lookup is advisory: match_confidence is capped below an identifier-verified resolve, and you should verify a candidate by its ABN or ACN before acting on it.
​
include
string[]
Optional. The enrichment blocks to compute (for example charity, licensing, screening). Defaults to the full set.

​
Response

​
query
object
Echoes the identifier or name you sent.
​
candidates
object[]
The resolved entities, best match first. Empty when the identifier or name is not found. Each candidate contains match_confidence, match_signals, canonical, conflicts, provenance_complete, and the enrichment blocks that apply.
​
disclaimer
string
A standing note that the API does not include directors, shareholders, or beneficial ownership. See Honest boundaries.
An identifier or name that is simply absent from the source returns a clean 200 with an empty candidates array, not an error. Only an upstream identity-source outage returns a 502. See Errors.

​
Examples

curl https://api.auo.com.au/v1/resolve \
  -H "Authorization: Bearer auo_sk_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{"abn": "46008583542"}'

curl https://api.auo.com.au/v1/resolve \
  -H "Authorization: Bearer auo_sk_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{"acn": "008583542"}'

curl https://api.auo.com.au/v1/resolve \
  -H "Authorization: Bearer auo_sk_test_your_key" \
  -H "Content-Type: application/json" \
  -d '{"name": "macquarie bank"}'
A company that holds an Australian Financial Services licence resolves with the licensing block populated:
Response (abridged)
{
  "query": { "abn": "46008583542" },
  "candidates": [
    {
      "match_confidence": 100,
      "match_signals": { "exact_identifier": "abn" },
      "canonical": {
        "entity_name": { "value": "MACQUARIE BANK LIMITED", "source": "ABR" },
        "entity_form": { "value": "company", "source": "ABR" },
        "abn": { "value": "46008583542", "source": "ABR" },
        "acn": { "value": "008583542", "source": "ABR" }
      },
      "licensing": {
        "afs_licensee": {
          "licence_number": "237502",
          "entity_name": "MACQUARIE BANK LIMITED",
          "status": null,
          "start_date": "2004-03-01",
          "end_date": null,
          "register": "ASIC_AFS_licensee"
        },
        "credit_licensee": null
      },
      "screening": {
        "dfat_sanctions": { "status": "no_match" },
        "asic_banned_org": { "status": "no_match" }
      },
      "provenance_complete": true
    }
  ],
  "disclaimer": "Verification and enrichment layer. Does NOT include directors, shareholders, or beneficial ownership; these are not available in Australian free public sources."
}

​
Enrichment blocks

Depending on the entity, a candidate may include:
BlockSourceWhat it carries
charityACNCCharity registration, size, registration date.
licensingASIC AFS + creditLicensee and representative records.
professional_registrationsASICFinancial adviser, registered auditor, SMSF auditor.
external_idsGLEIFThe LEI cross-walk (opencorporates, qcc, spglobal).
superannuationSuper Fund LookupFund status and USI products.
screeningDFAT + ASICSanctions, banned persons and orgs, insolvency, external administration.
icnORICIndigenous Corporation Number, for CATSI entities.
Blocks that do not apply to an entity return a safe empty shape, so the schema is stable.

​
See also

The entity model

entity_form, the ACN rule, and the trust to trustee edge.

Screen

The dedicated screening endpoint.

Authorizations

​
Authorization
string
header
required

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

Body

application/json

Send one of abn, acn, or name. If an identifier is sent together with a name, the identifier is used and the name is ignored.

​
abn
string

An 11-digit ABN (spaces are stripped before lookup).

​
acn
string

A 9-digit ACN (spaces are stripped before lookup).

​
name
string

Free-text entity name for fuzzy name search.

​
state
string

Optional state filter (e.g. VIC, NSW) used with name search.

​
postcode
string

Optional postcode filter used with name search.

​
mode
enum<string>

Name-search mode. Defaults to fuzzy when omitted.

Available options:
exact,
fuzzy

Response

Resolve result. candidates may be empty (entity not found or no name matches above the score floor).

​
query
object
required
​
candidates
object[]
required
​
disclaimer
string
required