API Reference - ABN Registrations

ABN 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.

ABN Registrations

Endpoint Overview
  • URL
    /api/v1/abn-registrations
  • Methods
    POST , GET
  • Agency
    Australian Taxation Office (ATO)
  • Use this endpoint to lodge new Australian Business Number (ABN) 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.

Quick links: Application Request Status

ABN Registration Request

A POST request to this endpoint will return a JSON response with the request ID.

/api/v1/abn-registrations
POST
{
    "entityType": "051",
    "entitySubType": "027",
    "entitySubTypeAdditional": "",
    "entitlement": {
        "firstQuestion": 20,
        "outcomeId": 20,
        "outcome": true,
        "questionnaire": [
            {
            "questionId": 20,
            "answerId": 44,
            "nextQuestionId": 0
            }
        ]
    },
    "applicant": {
        "organisation": {
            "acn": "123456789",
            "abn": "",
            "name": "MY DEMO COMPANY PTY LTD",
            "ultimateHoldingCompany": {
                "acn": "",
                "abn": ""
            }
        },
        "individual": {
            "title": "",
            "familyName": "",
            "givenName": "",
            "otherGivenName": "",
            "dateOfBirth": "",
            "genderCode": ""
        },
        "tfn": "123456789"
    },
    "applicationDetail": {
        "tfnIndicator": "",
        "abnApplicationIndicator": "",
        "tfnApplicationIndicator": ""
    },
    "applicationReason": {
        "code": "NEW",
        "existingBusinessAbn": "",
        "previousAbn": "",
        "firstTimeDirectorIndicator": true,
        "firstTimeContractorIndicator": "",
        "firstTimeSelfEmployedIndicator": ""
    },
    "businessActivity": {
        "code": "7172",
        "description": "Investment advisor, company or consulting service (including financial planning and portfolio management on a commission or fee basis)",
        "abnStartDate": "2021-01-01",
        "abnEndDate": "2021-01-01",
        "governmentIndicator": true,
        "agriculturalIndicator": true
    },
    "taxationInformation": {
        "governmentCode": "",
        "nonprofitIndicator": false,
        "incomeTaxExemptionIndicator": false,
        "taxAgentIdentifier": "",
        "superBenefitMembers": "",
        "superType": "",
        "superCode": "",
        "australianResidentIndicator": true
    },
    "mainAddresses": {
        "business": {
            "line2": "UNIT 4",
            "street": "9 KENT STREET",
            "locality": "SYDNEY",
            "state": "NSW",
            "postcode": "2000",
            "countryCode": ""
        },
        "postal": {
            "line2": "UNIT 4",
            "street": "9 KENT STREET",
            "locality": "SYDNEY",
            "state": "NSW",
            "postcode": "2000",
            "countryCode": "au"
        },
        "businessEmail": "john@doe.com",
        "correspondenceEmail": "john@doe.com",
        "phoneType": "",
        "phoneAreaCode": "1",
        "phoneNumber": "",
        "sameMainBusinessActivityIndicator": false,
        "businessActivityCode": "",
        "businessActivityDescription": "",
        "additionalBusinessLocationsIndicator": ""
    },
    "additionalAddresses": [
        {
        "line1": "",
        "line2": "",
        "locality": "",
        "state": "",
        "postCode": "",
        "countryCode": "au",
        "businessEmail": "",
        "phoneType": "",
        "phoneAreaCode": "1",
        "phoneNumber": "",
        "sameMainBusinessActivityIndicator": false,
        "businessActivityCode": "",
        "businessActivityDescription": ""
        }
    ],
    "associates": {
        "individuals": [
            {
            "title": "Mr",
            "familyName": "DOE",
            "givenName": "JOHN",
            "otherGivenName": "",
            "dateOfBirth": "1990-01-01",
            "genderCode": "",
            "positionHeld": ["DIR", "SEC"],
            "tfn": "123456789",
            "line2": "UNIT 4",
            "street": "9 KENT STREET",
            "locality": "SYDNEY",
            "state": "NSW",
            "postcode": "2000",
            "countryCode": "au"
            }
        ],
        "organisations": [
            {
            "acn": "",
            "arbn": "",
            "abn": "",
            "name": "",
            "incorporationDate": "1990-01-01",
            "positionHeld": ["DIR", "SEC"],
            "tfn": "",
            "line1": "",
            "line2": "",
            "locality": "",
            "state": "",
            "postCode": "",
            "countryCode": "au"
            }
        ],
        "other": {
            "legalRepresentativeIndicator": ""
        }
    },
    "superFundNoticeOfElection": {
        "governingRulesIndicator": false,
        "regulatoryElectionDate": "1900-01-01",
        "agePensionFundIndicator": false
    },
    "superFundTrusteeDisclosure": {
        "liquidatorAppointedIndicator": false,
        "disqualifiedOfficerIndicator": false,
        "receiverAppointedIndicator": false,
        "smsf12MonthsActivityIndicator": false,
        "trusteesBankruptIndicator": false,
        "civilPenaltyOrderIndicator": false,
        "convictionIndicator": false,
        "disqualifiedTrusteesOrDirectorsIndicator": false,
        "operationCeaseIndicator": false,
        "underOfficialManagementIndicator": false
    },
    "taxRegistrations": {
        "gst": {
            "registrationStartDate": "2021-01-01",
            "reasonCode": "",
            "turnoverRangeCode": "",
            "lodgementFrequencyCode": "",
            "cashAccountingIndicator": true,
            "importIndicator": true,
            "accountName": "",
            "bsb": "",
            "accountNumber": "",
            "accountHolderTypeCode": ""
        },
        "ftc": {
            "registrationStartDate": "1900-01-01",
            "fuelTypeCodeCollection": ["Other", "Petrol"],
            "heavyVehicleIndicator": true
        },
        "lct": {
            "registrationStartDate": "2016-01-01",
            "registrationRequiredIndicator": true,
            "activityCode": "",
            "liabilityRangeCode": "",
            "manufacturingPercent": 1.1,
            "wholesalePercent": 1,
            "importingPercent": 1,
            "retailingPercent": 1,
            "activityStatementRegistrationIndicator": true
        },
        "wet": {
            "registrationStartDate": "1900-01-01",
            "manufacturingIndicator": true,
            "wholesaleIndicator": true,
            "importingIndicator": true,
            "exportingIndicator": true,
            "indirectMarketingRetailerIndicator": true,
            "winePercent": 1,
            "beerPercent": 1,
            "spiritPercent": 1,
            "otherPercent": 1
        },
        "paygw": {
            "registrationStartDate": "2015-01-01",
            "legislationRequirementIndicator": true,
            "employeesCount": 1,
            "estimatedTaxWithheldAmount": 0.0,
            "lodgementChannelCode": "",
            "paymentSummaryProvisionMethodCode": "",
            "investmentBodyIndicator": true,
            "employerConditionsWorkingHolidayMakerIndicator": false
        },
        "fbt": {
            "activityStatusStartDate": "2015-01-01",
            "accountName": "",
            "bsb": "",
            "accountNumber": ""
        }
    },
    "authorisedContacts": [
        {
        "title": "",
        "familyName": "",
        "givenName": "",
        "positionHeld": "",
        "email": "",
        "mobilePhoneNumber": "",
        "afterHoursPhoneAreaCode": "",
        "afterHoursPhoneNumber": "",
        "businessHoursPhoneAreaCode": "",
        "businessHoursPhoneNumber": "",
        "businessHoursFaxAreaCode": "",
        "businessHoursFaxNumber": "",
        "preferredLanguageCode": "",
        "preferredLanguageOther": ""
        }
    ],
    "superFundFinancialDetails": {
        "accountName": "",
        "bsb": "",
        "accountNumber": "",
        "electronicServiceAlias": ""
    },
    "incomeTaxRefundFinancialDetails": {
        "accountName": "",
        "bsb": "",
        "accountNumber": ""
    },
    "declaration": {
        "fullName": "",
        "positionHeld": "",
        "phoneAreaCode": "",
        "phoneNumber": "",
        "date": "2016-03-01",
        "signatureAcceptanceIndicator": false,
        "signatureText": ""
    },
    "intermediaryDeclaration": {
        "abn": "",
        "fullName": "",
        "positionHeld": "OTH",
        "phoneAreaCode": "",
        "phoneNumber": "",
        "taxAgentIdentifier": "",
        "date": "2016-05-30",
        "signatureAcceptanceIndicator": true,
        "signatureText": ""
    },
    "testTransmissionIndicator": true
}

ABN Registration Response

{
    "response": {
        "requestId": 12239
    },
    "errors": []
}

ABN Registration Status Request & Response

A GET request to this endpoint will return a JSON reponse.

/api/v1/abn-registrations/{requestId}/status
GET
{
    "response": {
        "requestId": 12239,
        "status": "finished",
        "documentNumber": "8810120556472",
        "info": {
            "entityName": "MY DEMO COMPANY PTY LTD",
            "abn": "33612302303",
            "abnStartDate": "20210630",
            "abnEndDate": "",
            "dateOfAbnRegistration": "20210630",
            "taxRegistrations": {
                "gstRegistrationDate": "20210630",
                "paygRegistrationDate": "20210630"
            }
        }
    },
    "errors": []
}