API product
Using this API product
API list
Release notes

SMSF Alias lookup API

You can use the SMSF alias lookup API to verify the details of a self-managed super fund (SMSF) alias and its associated gateway.
Last modified
Risk rating
Using this API product

Description

You can use the SMSF alias lookup API to verify the details of a self-managed super fund (SMSF) alias and its associated gateway.

If you are an entity that is responsible for sending contribution and rollover messages to SMSFs in the SuperStream Standard (for example, clearing houses or other gateways providers), you can use this API to ensure the SMSF alias details are correct.

A mandatory step for setting up an SMSF is to get an electronic service address.

Back to top

API risk rating

1 - No risk

For more information, see API risk rating.

Back to top

Authentication

See: M2M client authentication.

Back to top

Scopes

ato.smsfaliaslookup.providers.r

Back to top

Rate Limit

Not applicable.

Back to top

Production requirements

Before you can request production access for this API, you must meet the requirements for production access.

API List

SMSF alias lookup API

Overview

This API returns a list of SMSF message providers

This API has the following endpoints:

  • GET / Use this endpoint to get the current version and status of the SMSF Alias Lookup API.
  • GET /specs/yaml Use this endpoint to view the SMSF Alias Lookup API in YAML format.
  • GET /specs/spec.yaml Use this endpoint to download the SMSF Alias Lookup API in YAML format.
  • GET /providers Use this endpoint to get the full list of SMSF Alias messaging providers

API specification

Release notes

Security scopes updated 28 October, 2022.

Security scope associated with this API has changed.

The new scope is: ato.smsfaliaslookup.providers.r

Please refer to M2M Client Authentication on how to provide the scopes while making a call to this API.

Version 1.0.58 released on 17 June, 2022 (latest).

The following are changes to the API in the sandbox enviornment - Australia Post provider data is updated.

The provider data for Australia Post has been changed from "certifications": ["CONT1.0-X"] to "certifications": ["GROL3.0-X","ROLL3.0-X","CONT1.0-X"].The change will be in effect starting from 08/05/2022.