GST Property Settlement API

API Description

The GST Property Settlement API allows software users to lodge the following forms directly to the Australian Taxation Office (ATO).

• Form one: GST property settlement withholding notification
• Form two: GST Property settlement date confirmation

Form one notifies the ATO that a purchaser has entered a contract of sale and has a withholding obligation.

You can complete and lodge Form one any time after the contract has been entered into and you have a written notification from your supplier. The form must be lodged by the due date for payment of the withholding amount – this is usually settlement date or the first instalment date.

Form two confirms your settlement date and establishes a purchaser withholding account, where the purchaser withholding liability is recorded until payment is made.

• You can complete and lodge Form two for:
  • a standard land contract, either:
    • within 2 business days before settlement
    • on the day of settlement
    • on the next business day after settlement
  • an instalment contract – when the first instalment is paid.

For further information to complete Form one, go to Lodge forms via e-conveyancing.

Supplier Notification

Suppliers need to provide the purchaser with a written notification advising if there is a withholding obligation or not. The notification can be incorporated into the contract of sale or in a separate notice. Where there is a withholding notification, the notice from the supplier should include:

• The name and ABN of all suppliers
• GST branch number (if applicable)
• The amount you must pay to the ATO (rounded down to the nearest dollar)
• That date the withholding amount is to be paid to the ATO
• GST inclusive contract price (plus the GST inclusive market value of non-monetary consideration).

Where the purchaser has received notification from the supplier to withhold, you are required to submit Form one.

Lodgment of Form one

Form one is submitted through the GST Property Settlement API (POST /propertySettlements).

The following details are captured on Form one:

• Contact details - who has completed the form:

  • Contact name
  • Representative’s business name
  • Phone number
  • Email address
  • Digital settlement service provider
  • Digital settlement file number
   

• Property details – details of the property purchased:

  • Property address of property purchased
  • Property particulars (volume, folio, etc.)
  • Contract date
  • Contract price
   

  10 properties can be entered on Form one, where multiple properties have been purchased under the one contract or multiple properties are settling on the same day.

• Purchaser details – details of the purchaser buying the property:

  • Purchaser full name
  • TFN or ABN (if available)
  • Address
  • Phone number
  • Percentage of ownership
   

  10 purchasers can be entered on Form one where there have been multiple purchasers on the title.

• Supplier details – details of the entity selling the property:

  • Entity name
  • ABN
  • GST branch number (if applicable)
  • Address
  • Phone number
  • Proportion of withholding amount
  • Total withholding amount
   

  10 suppliers can be entered on Form one where there have been multiple suppliers selling the property.

  The supplier details are for the entity liable to pay GST on the supply of the property. The supplier details may be different to the vendor on the contract or the registered proprietor on the certificate of title. For example, if the vendor is part of a GST group or under external administration.

  For partnerships – enter the name of the partnership. You don't need to list individual partner's names on the form.

To support consistency and reduce manual date entry, DSPs are encouraged to implement pre-population logic that transfers relevant information from the contract and supplier notification into the appropriate parts of the form. This approach helps ensure data accuracy and alignment with the expected structure of the form.

ATO Processing

• The ATO receives Form one and issues a lodgment reference number and payment reference number.

Lodgment confirmation

• A lodgment confirmation is returned to the lodger.

Lodgment of Form two

Form two is submitted through the GST Property Settlement API (POST /changeOfPropertySettlements).

The following details are captured on Form two:

• Contact details - who has completed the form:

  • Contact name
  • Representative’s business name
  • Phone number
  • Email address
  • Digital settlement service provider
  • Digital settlement file number
   

• Transaction details – details to complete the remainder of the form

  • Lodgment reference number (LRN provided upon Form one lodgment)
  • Payment reference number (PRN provided upon Form one lodgment)
  • Actual settlement date
   

  To support consistency and reduce manual date entry, DSPs are encouraged to implement pre-population logic that transfers relevant information from the contract and supplier notification into the appropriate parts of the form. This approach helps ensure data accuracy and alignment with the expected structure of the form.

ATO Processing

• The ATO receives Form two which is used to post the liability against the purchaser’s account.

Lodgment confirmation and payment

• A lodgment confirmation is returned to the lodger.
• The lodging entity will make a payment to the ATO through existing payment channels.

Scopes

ato.apGSTPropertySettlement

Rate Limit

Not Applicable

Response Messages

For response messages specific to the GST Property Settlement Date Confirmation API, see GST Property Settlement API - response messages.

For response messages common to all the APIs available in our API Catalogue, see Common response messages.

Release Notes

API Version: 0.0.3

• Release date: 16 April 2026 (Sandbox)
• Description: Initial release for consultation.

Go back to Property Settlement Service