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>"
}
'
{
  "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>"
}
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 exactly one of abn, acn, or name. Providing both an identifier and a name returns 400.
​
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 AUO 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"}'
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

Exactly one of abn, acn, or name is required. Providing an identifier together with a name returns 400.

​
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