API Reference - Business Name Registrations

Business Name Registrations endpoint. The Business API suite exposes registration, lodgement, lookup and related functions that can be used for a variety of purposes. For the latest release information please check our release notes.

Business Name Registrations

Download Postman collection (all entity types)
Endpoint Overview
  • Production
    /api/v2/business-name-registrations
  • Sandbox
    /api/test/v2/business-name-registrations
  • Methods
    POST , GET
  • Agency
    Australian Securities and Investments Commission (ASIC)
  • Use this endpoint to lodge new business name registration applications. Use the helpers to check the status of an application or retrieve its entire transmission log. All responses are delivered in JSON format.

Business Name Registration Request

A POST request to this endpoint will return a JSON response with the request ID. There are two options for generalInformation.paymentMethod: invoice (where you receive an ASIC invoice via email, that you would have to pay as a service provider with a bank transfer), or card (where you receive an ASIC online payment link, that you would need to use to pay for the application using your card). It's a single field on an otherwise identical payload - there is no separate request shape per payment method.

/api/v2/business-name-registrations
POST

One example per entity.type.

Individual (IND)

{
    "generalInformation": {
        "businessName": "SAMPLE HERBAL BLENDS",
        "term": "3",
        "paymentMethod": "card",
        "email": "[email protected]"
    },
    "businessAddress": {
        "unitOrOfficeNumber": null,
        "streetNumber": "1",
        "streetName": "EXAMPLE",
        "streetType": "STREET",
        "locality": "SAMPLE SUBURB",
        "state": "QLD",
        "postCode": "4000"
    },
    "serviceAddress": {
        "postalType": "PO BOX",
        "postalNumber": "1",
        "locality": "SAMPLE SUBURB",
        "state": "QLD",
        "postCode": "4000"
    },
    "entity": {
        "type": "IND",
        "abn": "00000000000",
        "individual": {
            "name": {
                "familyName": "SMITH",
                "givenNames": "JOHN",
                "otherGivenNames": null
            },
            "birthDetails": {
                "date": "1985-06-15",
                "cityTown": "Sample City",
                "state": "QLD",
                "countryOfBirth": "AU"
            },
            "address": {
                "unitOrOfficeNumber": null,
                "streetNumber": "1",
                "streetName": "EXAMPLE",
                "streetType": "STREET",
                "locality": "SAMPLE SUBURB",
                "state": "QLD",
                "postCode": "4000",
                "country": "AU"
            }
        }
    },
    "signatory": {
        "name": {
            "familyName": "SMITH",
            "givenNames": "JOHN"
        },
        "declaresTrueAndCorrectIndicator": "1"
    },
    "testTransmissionIndicator": "0"
}

Incorporated Body (IB) - use this for companies

{
    "generalInformation": {
        "businessName": "SAMPLE TRADING CO",
        "term": 3,
        "paymentMethod": "card",
        "email": "[email protected]"
    },
    "businessAddress": {
        "unitOrOfficeNumber": "1",
        "streetNumber": "1",
        "streetName": "EXAMPLE",
        "streetType": "ST",
        "locality": "SAMPLE SUBURB",
        "state": "QLD",
        "postCode": "4000",
        "country": "AU"
    },
    "serviceAddress": {
        "unitOrOfficeNumber": "1",
        "streetNumber": "1",
        "streetName": "EXAMPLE",
        "streetType": "ST",
        "locality": "SAMPLE SUBURB",
        "state": "QLD",
        "postCode": "4000",
        "country": "AU"
    },
    "entity": {
        "type": "IB",
        "subType": "IB",
        "abn": "00000000000",
        "organisation": {
            "name": "SAMPLE COMPANY PTY LTD",
            "acn": "000000019"
        }
    },
    "signatory": {
        "name": {
            "givenNames": "John",
            "familyName": "Smith"
        },
        "declaresTrueAndCorrectIndicator": true
    },
    "testTransmissionIndicator": false
}

Partnership (PTSH)

{
    "generalInformation": {
        "businessName": "SAMPLE PARTNERS",
        "term": "1",
        "paymentMethod": "card",
        "email": "[email protected]"
    },
    "businessAddress": {
        "unitOrOfficeNumber": null,
        "streetNumber": "1",
        "streetName": "EXAMPLE",
        "streetType": "STREET",
        "locality": "SAMPLE SUBURB",
        "state": "NSW",
        "postCode": "2000"
    },
    "serviceAddress": {
        "postalType": "PO BOX",
        "postalNumber": "1",
        "locality": "SAMPLE SUBURB",
        "state": "NSW",
        "postCode": "2000"
    },
    "entity": {
        "type": "PTSH",
        "subType": "PTR",
        "abn": "00000000000",
        "organisation": {
            "name": "SAMPLE PARTNERS"
        },
        "partners": [
            {
                "individual": {
                    "name": {
                        "givenNames": "JOHN",
                        "familyName": "SMITH"
                    },
                    "birthDetails": {
                        "date": "1985-06-15",
                        "cityTown": "Sample City",
                        "countryOfBirth": "AU",
                        "state": "NSW"
                    },
                    "address": {
                        "streetNumber": "1",
                        "streetName": "EXAMPLE",
                        "streetType": "STREET",
                        "locality": "SAMPLE SUBURB",
                        "state": "NSW",
                        "postCode": "2000",
                        "country": "AU"
                    }
                }
            },
            {
                "organisation": {
                    "name": "SAMPLE HOLDINGS PTY LTD",
                    "acn": "000000019"
                }
            }
        ]
    },
    "signatory": {
        "name": {
            "familyName": "SMITH",
            "givenNames": "JOHN"
        },
        "declaresTrueAndCorrectIndicator": "1"
    },
    "testTransmissionIndicator": "0"
}

Unincorporated Trust (USTR)

{
    "generalInformation": {
        "businessName": "SAMPLE UNIT TRUST",
        "term": "1",
        "paymentMethod": "card",
        "email": "[email protected]"
    },
    "businessAddress": {
        "unitOrOfficeNumber": null,
        "streetNumber": "1",
        "streetName": "EXAMPLE",
        "streetType": "STREET",
        "locality": "SAMPLE SUBURB",
        "state": "VIC",
        "postCode": "3000"
    },
    "serviceAddress": {
        "postalType": "PO BOX",
        "postalNumber": "1",
        "locality": "SAMPLE SUBURB",
        "state": "VIC",
        "postCode": "3000"
    },
    "entity": {
        "type": "USTR",
        "subType": "USTR",
        "abn": "00000000000",
        "organisation": {
            "name": "SAMPLE UNIT TRUST",
            "acn": "000000019"
        }
    },
    "signatory": {
        "name": {
            "familyName": "SMITH",
            "givenNames": "JOHN"
        },
        "declaresTrueAndCorrectIndicator": "1"
    },
    "testTransmissionIndicator": "0"
}

Joint Venture (JV)

{
    "generalInformation": {
        "businessName": "SAMPLE JOINT VENTURE",
        "term": "1",
        "paymentMethod": "card",
        "email": "[email protected]"
    },
    "businessAddress": {
        "unitOrOfficeNumber": null,
        "streetNumber": "1",
        "streetName": "EXAMPLE",
        "streetType": "STREET",
        "locality": "SAMPLE SUBURB",
        "state": "WA",
        "postCode": "6000"
    },
    "serviceAddress": {
        "postalType": "PO BOX",
        "postalNumber": "1",
        "locality": "SAMPLE SUBURB",
        "state": "WA",
        "postCode": "6000"
    },
    "entity": {
        "type": "JV",
        "subType": "JV",
        "abn": "00000000000",
        "organisation": {
            "name": "SAMPLE JOINT VENTURE"
        },
        "partners": [
            {
                "organisation": {
                    "name": "SAMPLE HOLDINGS PTY LTD",
                    "acn": "000000019"
                }
            },
            {
                "organisation": {
                    "name": "EXAMPLE VENTURES PTY LTD",
                    "acn": "000000032"
                }
            }
        ]
    },
    "signatory": {
        "name": {
            "familyName": "SMITH",
            "givenNames": "JOHN"
        },
        "declaresTrueAndCorrectIndicator": "1"
    },
    "testTransmissionIndicator": "0"
}

Frequently Asked Questions

What are the valid values for entity.type?
Exactly five: IND (individual), IB (incorporated body - use this for companies), PTSH (partnership), USTR (unincorporated trust), JV (joint venture).
What are the valid entity.subType values?
Use the entity type itself as the subtype for IB, USTR and JV (e.g. "subType": "IB"), and PTR for a standard partnership.
What's the structure of entity.partners, and what fields does each partner need?
An array where each entry is either an individual or a company - there is no explicit "type" flag on a partner entry, which one you're sending is inferred from whichever key is present.
  • Individual partner: individual.name.familyName, individual.name.givenNames, individual.birthDetails.date, individual.birthDetails.cityTown, individual.birthDetails.countryOfBirth (plus state if born in Australia), and a full individual.address.
  • Company partner: just organisation.name and organisation.acn.
Is partner email required?
No - there is no email field anywhere on a partner record at all, individual or company.
Any minimum or maximum number of partners?
No minimum or maximum.
For IB (Incorporated Body), what's required under entity.organisation, and are both ABN and ACN required?
entity.organisation.name is required. entity.abn (top-level, not inside organisation) is required for every entity type, and entity.organisation.acn is also required specifically for IB - so yes, both. No other IB-specific fields exist beyond the standard businessAddress, serviceAddress and signatory blocks every entity type needs.

Business Name Registration Response

{
    "requestId": 185,
    "status": "new",
    "warnings": null,
    "errors": null
}

Business Name Registration Status Request & Response

A GET request to this endpoint will return a JSON reponse. When you use card as the paymentMethod, you will receive the certificate as well in the response, otherwise the response will only contain the application confirmation PDF.

/api/v2/business-name-registrations/{requestId}/status
GET
{
    "requestId": 7435,
    "status": "finished",
    "documentNumber": "1-CHMX9JL",
    "response": {
        "certificateUrl": "https://uateaswlsvs.asic.gov.au/CustomerDropBoxR1/corresp?f=Notification_1-CHMX9LS.PDF&e=20230808&i=UATA0TaBoUqRKmICk5LjWgymVCQRcMKCatFhvJDmnlEjG1a4%3D",
        "receiptNumber": "27794628"
    },
    "warnings": null,
    "errors": null
}

When using invoice as the paymentMethod, the transactionDocumentUrl contains a link to a document that confirms that the application was received by ASIC. Within the next 24h you will receive an email directly from ASIC with the invoice asseciated with the application. You have 10 days to make the payment and finalise the business name registration.

{
    "requestId": 185,
    "status": "finished",
    "documentNumber": "1-CHMX9UF",
    "response": {
        "transactionDocumentUrl": "https://asic.gov.au/corresp?f=Notification_1-CHMX9UF.PDF&e=20230523&i=UATA0sBL7JZvrlXFah6%2BbLdSs6SqjFn%2Flf6SwF4ALHBsriCw%3D"
    },
    "warnings": null,
    "errors": null
}

When using card as the paymentMethod, the transactionPaymentUrl contains a link to an ASIC credit / debit card payment facility. Once you open the link in a browser and pay the application, ASIC will instantly process the registration.

{
    "requestId": 185,
    "status": "wating ASIC CC payment",
    "response": {
        "transactionFee": "39.00",
        "transactionPaymentUrl": "https://asic.gov.au/index.aspx?SessionId=64549dcb-2206-4fe6-9f98-929c7b1a7d7d&SST=8908e5f3-dfc2-456c-9ed9-916b658116aa"
    },
    "errors": null,
    "warnings": null
}

A card payment link expires, and the payer can also cancel or have their card declined at ASIC's payment page. When any of that happens, the status endpoint returns "status": "cancelled". This refers to the payment attempt, not the application itself - do not submit a new application request when you see it. Call Refresh Payment Link on the same requestId instead - it re-checks the lodgement with ASIC and re-issues a fresh link, re-lodging the same application under a new ASIC transaction reference first if the old one was released. Submitting a fresh application instead risks ASIC rejecting it as a duplicate of the still-reserved name.

A GET request to this endpoint requests a fresh ASIC payment link for a card-payment application whose original link expired, was cancelled, or had its card payment declined ("status": "cancelled" - see above). No request body. This does not create a new application - it recovers the existing one under the same requestId.

/api/v2/business-name-registrations/{requestId}/requestNewPaymentLink
GET

A successful call returns immediately with "status": "payment link requested" - poll Status as usual to retrieve the fresh transactionPaymentUrl once it's ready.

{
    "requestId": 185,
    "status": "payment link requested",
    "errors": null,
    "warnings": null
}

If the application is already fully registered, or payment has already been received, the call fails instead of re-issuing a link:

{
    "requestId": 185,
    "status": "finished",
    "errors": [
        { "details": "Registration already complete", "target": null }
    ],
    "warnings": null
}