Company relationships and roles held

Read the ASIC relational extract for a company by ACN: companies it is ultimate holding company or director of, licences held and shares in other companies.

Company relationships

An ordinary company extract describes a company from the inside: its own officers, addresses and members. The relational extract looks outward and shows where the company appears on other records across the ASIC register: the companies for which it is the ultimate holding company, the corporations it is a director of, the foreign companies it acts as local agent for, the managed investment schemes it is responsible entity or trustee of, the financial services licences it holds, and the proprietary companies in which it is a recorded member. This endpoint returns that extract as three structured lists, the fastest way to map a corporate group downwards from a parent entity. The data comes from a relational extract you have already purchased with POST /v1/companies/{id}/extracts using "type": "relational", and is read back for free as described in the purchasing guide.

GEThttps://api.asicapi.dev/v1/companies/{id}/relationships

curl "https://api.asicapi.dev/v1/companies/001000004/relationships?status=all" \
  -H "Authorization: Bearer $ASICAPI_KEY"

Example response

Response

{
  "object": "companyRelationships",
  "company": {
    "acn": "001000004",
    "formatted": "001 000 004",
    "numberType": { "code": "ACN", "label": "Australian Company Number" },
    "name": "ACME HOLDINGS LIMITED",
    "type": { "code": "APUB", "label": "Australian Public Company" },
    "status": { "code": "REGD", "label": "Registered" },
    "abn": "51001000004",
    "registeredCharity": false,
    "stateOfRegistration": { "code": "NSW", "label": "New South Wales" },
    "previousStateNumber": "17654321",
    "placeOfRegistration": "NEW SOUTH WALES",
    "registrationDate": "1972-11-02"
  },
  "rolesHeld": [
    {
      "object": "roleHeld",
      "role": { "code": "AG", "label": "Local Agent" },
      "status": { "code": "C", "label": "Current" },
      "appointedAt": "2019-05-06",
      "ceasedAt": null,
      "company": {
        "acn": "000000019",
        "formatted": "000 000 019",
        "numberType": { "code": "ARBN", "label": "Australian Registered Body Number" },
        "name": "ACME OVERSEAS INC",
        "type": { "code": "FNOS", "label": "Foreign Company (Overseas)" },
        "status": { "code": "REGD", "label": "Registered" },
        "abn": null,
        "registeredCharity": false
      },
      "address": {
        "careOf": null,
        "line1": "LEVEL 20",
        "street": "1 EXAMPLE PLACE",
        "locality": "SYDNEY",
        "state": "NSW",
        "postcode": "2000",
        "country": "AUSTRALIA"
      },
      "sourceDocument": { "documentNumber": "5E6677889", "qualifier": null }
    },
    {
      "object": "roleHeld",
      "role": { "code": "UH", "label": "Ultimate Holding Company" },
      "status": { "code": "C", "label": "Current" },
      "appointedAt": "2010-07-01",
      "ceasedAt": null,
      "company": {
        "acn": "004085616",
        "formatted": "004 085 616",
        "numberType": { "code": "ACN", "label": "Australian Company Number" },
        "name": "ACME WIDGETS PTY LTD",
        "type": { "code": "APTY", "label": "Australian Proprietary Company" },
        "status": { "code": "REGD", "label": "Registered" },
        "abn": "53004085616",
        "registeredCharity": false
      },
      "address": null,
      "sourceDocument": { "documentNumber": "7E1234567", "qualifier": "AR 2010" }
    },
    {
      "object": "roleHeld",
      "role": { "code": "UH", "label": "Ultimate Holding Company" },
      "status": { "code": "E", "label": "Ceased/Former" },
      "appointedAt": "2010-07-01",
      "ceasedAt": "2024-03-31",
      "company": {
        "acn": "004249987",
        "formatted": "004 249 987",
        "numberType": { "code": "ACN", "label": "Australian Company Number" },
        "name": "ACME DISTRIBUTION PTY LTD",
        "type": { "code": "APTY", "label": "Australian Proprietary Company" },
        "status": { "code": "EXAD", "label": "** Under External Administration And/Or Controller Appointed **" },
        "abn": "68004249987",
        "registeredCharity": false
      },
      "address": null,
      "sourceDocument": { "documentNumber": "2E3344556", "qualifier": null }
    }
  ],
  "licences": [
    {
      "object": "licence",
      "type": { "code": "FL", "label": "Financial Services Licencee" },
      "status": { "code": "C", "label": "Current" },
      "licenceNumber": "234567",
      "licenceStatus": { "code": "APPR", "label": "Application approved and licence granted" },
      "from": "2004-03-11",
      "to": null,
      "address": {
        "careOf": null,
        "line1": "LEVEL 20",
        "street": "1 EXAMPLE PLACE",
        "locality": "SYDNEY",
        "state": "NSW",
        "postcode": "2000",
        "country": "AUSTRALIA"
      },
      "sourceDocument": { "documentNumber": "4E1212121", "qualifier": null }
    }
  ],
  "shareholdings": [
    {
      "object": "shareholding",
      "classCode": "ORD",
      "numberHeld": 500,
      "beneficiallyOwned": true,
      "fullyPaid": true,
      "status": { "code": "C", "label": "Current" },
      "jointHolding": false,
      "company": {
        "acn": "004085616",
        "formatted": "004 085 616",
        "numberType": { "code": "ACN", "label": "Australian Company Number" },
        "name": "ACME WIDGETS PTY LTD",
        "type": { "code": "APTY", "label": "Australian Proprietary Company" },
        "status": { "code": "REGD", "label": "Registered" },
        "abn": "53004085616",
        "registeredCharity": false
      },
      "address": {
        "careOf": null,
        "line1": "LEVEL 20",
        "street": "1 EXAMPLE PLACE",
        "locality": "SYDNEY",
        "state": "NSW",
        "postcode": "2000",
        "country": "AUSTRALIA"
      },
      "sourceDocument": { "documentNumber": "0E5123456", "qualifier": null }
    }
  ],
  "extract": {
    "id": "ext_01J9AD7F2T5ZP1",
    "type": "relational",
    "purchasedAt": "2026-09-04T03:15:02Z",
    "asOf": "2026-09-04T03:15:00Z"
  },
  "meta": { "billable": false, "product": null, "requestId": "req_01J8ZKD8E9F0G1H" }
}

Response fields

Field	Type	Description
`object`	string	Always `companyRelationships`.
`company`	object	The subject company. A company summary extended with `stateOfRegistration`, `previousStateNumber`, `placeOfRegistration` and `registrationDate`.
`rolesHeld[]`	roleHeld[]	Roles the subject company holds in other organisations, in ASIC order (see notes).
`rolesHeld[].object`	string	Always `roleHeld`.
`rolesHeld[].role`	code	`AG` local agent, `DR` director, `UH` ultimate holding company, `TM` trust management company, `TR` trustee, `RN` responsible entity.
`rolesHeld[].status`	code	`C` current or `E` ceased.
`rolesHeld[].appointedAt`	date or null	Date the role commenced.
`rolesHeld[].ceasedAt`	date or null	Date the role ceased.
`rolesHeld[].company`	object	Summary of the organisation in which the role is held, including its `numberType` (ACN, ARBN or ARSN), `status` and `abn`.
`rolesHeld[].address`	address or null	Address recorded against the role, where ASIC holds one.
`rolesHeld[].sourceDocument`	object or null	Document that last changed the record, with `AR` or `FR` qualifier where applicable.
`licences[]`	licence[]	Licences held by the subject company under the Corporations Act.
`licences[].object`	string	Always `licence`.
`licences[].type`	code	`FL` financial services licensee, `SD` securities dealer, `IA` investment adviser, `FB` futures broker, `FD` futures adviser, `FR` financial services representative, `FX` banned financial services representative.
`licences[].status`	code	`C` current or `E` ceased.
`licences[].licenceNumber`	string or null	The licence number, for example an Australian financial services licence number.
`licences[].licenceStatus`	code or null	`APPR` granted, `SUSP` suspended, `NOAC` revoked, `PEND` decision pending, `REFS` refused.
`licences[].from`	date	Date the licence was granted or the record commenced.
`licences[].to`	date or null	Date the licence ceased.
`licences[].address`	address or null	Address recorded against the licence.
`licences[].sourceDocument`	object or null	Document that last changed the record.
`shareholdings[]`	shareholding[]	Shares or interests the subject company holds in other companies and schemes.
`shareholdings[].object`	string	Always `shareholding`.
`shareholdings[].classCode`	string	Share class code in the issuing company.
`shareholdings[].numberHeld`	integer	Number of shares or interests held.
`shareholdings[].beneficiallyOwned`	boolean or null	Whether the subject company holds the shares beneficially.
`shareholdings[].fullyPaid`	boolean or null	Whether the shares are fully paid.
`shareholdings[].status`	code	`C` current or `E` ceased (the company is no longer ranked among the recorded members).
`shareholdings[].jointHolding`	boolean	Whether the holding is joint with other members.
`shareholdings[].company`	object	Summary of the issuing company or scheme.
`shareholdings[].address`	address or null	The subject company's address as recorded on the issuer's member register.
`shareholdings[].sourceDocument`	object or null	Document that last changed the holding.
`extract`	object	The relational extract the data was read from: `id`, `type` (always `relational`), `purchasedAt` and `asOf`. Roles or holdings recorded after `asOf` are not reflected.
`meta.billable`	boolean	Always `false`. Reading an extract you hold is free.
`meta.product`	string or null	Always `null`.
`meta.requestId`	string	Request identifier.

Errors

Code	HTTP	When it occurs
`extract_required`	402	You hold no unexpired relational extract for this company. Current and historical extracts do not contain relationships. `error.details.purchase.body` is `{ "type": "relational" }`.
`extract_not_found`	404	The `extract` id does not exist on your account.
`extract_expired`	410	The `extract` id refers to an extract older than 12 months.
`extract_owner_mismatch`	403	The `extract` id belongs to a different account, or is not a relational extract of this company.
`acn_invalid`	400	The number fails the ASIC check digit test.
`company_not_found`	404	No organisation with this identifier.
`abn_and_acn_supplied`	400	Both an ABN and an ACN were supplied.
`abn_invalid`	400	The ABN fails its check digit test.
`abn_not_acn_based`	400	The ABN does not embed an ACN.
`abn_not_found`	404	No company matches the ACN embedded in the ABN, or that company has no ABN.
`extract_unavailable_for_type`	422	Relational extracts are only available for `APUB`, `APTY`, `FNOS` and `RACN`.
`validation_error`	422	Unknown `status` value.
`unauthorized`	401	Missing or invalid API key.
`rate_limited`	429	Rate limit exceeded.
`asic_unavailable`	503	The ASIC register is offline.

Notes from the ASIC register

What the extract covers. ASIC's printed relational extract carries this heading: The following is an extract from the ASIC database showing where relevant; Proprietary companies in which the subject corporation is a member (only the top twenty members), Companies for which the subject corporation is the Ultimate Holding Company, Corporations for which the subject corporation is a director, foreign companies for which the subject company is a local agent, Securities dealers licenses held by the subject company, Securities investment advisers licenses held by the subject company, Futures dealers licenses held by the subject company, Futures advisers licenses held by the subject company, Managed Investment schemes for which the subject is the responsible entity.
Snapshot. The lists reflect the register at extract.asOf. A subsidiary that notified a new ultimate holding company after that date will only appear in a newly purchased relational extract.
No relational data. When a company holds no roles, licences or shareholdings anywhere on the register, the purchase itself fails with no_relational_data and nothing is billed, so there is never an empty relational extract to read.
Ordering of roles. Current roles come first in the sequence AG, DR, UH, TM, TR, RN, followed by ceased roles in the same role sequence and in reverse chronological order of ceasing.
Downward, not upward. The extract shows companies for which the subject is the ultimate holding company. To find a company's own ultimate holding company, look for the UH office holder on its office holders list.
Top 20 members. Shareholdings come from the member registers of proprietary companies, where ASIC records only the twenty largest members per class plus ties at rank twenty. A subject company holding a small parcel in a widely held company will not appear. A ceased shareholding may only mean the company dropped out of the top twenty. Public companies do not notify members to ASIC, so holdings in public companies never appear.
Corporate directors. An Australian company cannot be a director of another Australian company, but a body corporate can be a director of certain registered bodies and foreign companies, which is why DR appears among the roles.
Licences. The securities and futures licence types (SD, IA, FB, FD) were replaced by the Australian financial services licence (FL) from 2002 to 2004, but historical licences remain on the register.
ABN. ASIC adds the ABN to relational extracts from its Australian Business Register feed for companies that have one.
Sandbox. In the sandbox, company names in the related records are replaced with placeholders.

Company relationships and roles held