Loading...
Sign in to see the examples with your own API key.

Company

The Company API returns an ABN's record, by its ABN or by its company's ACN: who it belongs to, whether it is active, and whether it is registered for GST. Pass the 'Id' of a Companies suggestion, or a number a customer typed.

Request

GET https://api.getaddress.io/company/{number}?api-key={your-api-key}
Example

Request

GET https://api.getaddress.io/company/11000003378?api-key={your-api-key}

Response

{
    "abn": "11000003378",
    "acn": "000003378",
    "name": "BBC HARDWARE LIMITED",
    "entity_type": "Australian Public Company",
    "entity_type_code": "PUB",
    "abn_status": "active",
    "abn_status_from": "1999-11-01",
    "gst_registered": false,
    "gst_status_from": "2009-01-01",
    "state": "VIC",
    "postcode": "3121",
    "other_names": [
        { "type": "trading", "name": "BBC HARDWARE" },
        { "type": "other", "name": "HARDWARE HOUSE" }
    ],
    "data_as_at": "2026-09-30"
}

Response Fields

Field Description
abnThe 11-digit ABN.
acnThe 9-digit ACN, for a company registered with ASIC. Null otherwise.
nameThe legal name. For a sole trader that is the person's name, as the register publishes it.
entity_type, entity_type_codeThe register's entity type and its code, e.g. "Australian Private Company" and PRV.
abn_status, abn_status_fromAlways active, and the day it became so.
gst_registeredRegistered for GST now.
gst_status_fromThe day GST registration started, or ended when gst_registered is false. Null if never registered.
state, postcodeThe main business location. The register publishes no street address.
other_namesBusiness (business), trading and other names the ABN goes by.
data_as_atThe date of the register's weekly extract the record came from.

Usage

  • Each successful Company request counts as 1 look-up against your plan's daily allowance.
  • A number that is not an 11-digit ABN or 9-digit ACN, or whose check digit does not match, returns 400 and costs nothing.
  • A number no active ABN carries returns 404 and costs nothing. Cancelled ABNs are not held, so a cancelled ABN returns 404.
  • It accepts a domain token in place of an API key.

Rate Limiting

Your subscription's plan will limit the number of requests per 5 minute span. Exceeding your plan's rate limit will return a HTTP 429 response.
The Retry-After HTTP header contains the number of seconds until a successful retry can be made.

Top