Validate superannuation fund

curl 'https://qa-super.mygigsters.com.au/v1/contributions/fund/validate' -X POST \
    -u "apiUsername:apiPassword"  \
    -H "Content-Type: application/json" --data '{"fundUsis":["40328908469310"]}'

const response = await fetch("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate", {
  method: "POST",
  headers: {
    Authorization: "Basic " + Buffer.from("apiUsername:apiPassword").toString("base64"),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "fundUsis": [
      "40328908469310"
    ]
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://qa-super.mygigsters.com.au/v1/contributions/fund/validate",
    auth=("apiUsername", "apiPassword"),
    json={
        "fundUsis": [
            "40328908469310",
        ],
    },
)

print(response.json())

require "net/http"
require "json"
require "uri"

uri = URI("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate")
request = Net::HTTP::Post.new(uri)
request.basic_auth("apiUsername", "apiPassword")
request["Content-Type"] = "application/json"
request.body = <<~JSON
  {
    "fundUsis": [
      "40328908469310"
    ]
  }
JSON

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

<?php

$ch = curl_init("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate");

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_USERPWD => "apiUsername:apiPassword",
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "fundUsis": [
    "40328908469310"
  ]
}
JSON,
]);

$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;

public class Example {
    public static void main(String[] args) throws Exception {
        String credentials = Base64.getEncoder()
            .encodeToString("apiUsername:apiPassword".getBytes());

        String body = String.join("\n",
            "{",
            "  \"fundUsis\": [",
            "    \"40328908469310\"",
            "  ]",
            "}"
        );

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate"))
            .header("Authorization", "Basic " + credentials)
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "fundUsis": [
    "40328908469310"
  ]
}`)

	req, err := http.NewRequest("POST", "https://qa-super.mygigsters.com.au/v1/contributions/fund/validate", body)
	if err != nil {
		panic(err)
	}
	req.SetBasicAuth("apiUsername", "apiPassword")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Post, "https://qa-super.mygigsters.com.au/v1/contributions/fund/validate");
request.Headers.Authorization = new AuthenticationHeaderValue(
    "Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("apiUsername:apiPassword")));
request.Content = new StringContent(@"{
  ""fundUsis"": [
    ""40328908469310""
  ]
}", Encoding.UTF8, "application/json");

var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

{
  "success": true,
  "statusCode": 200,
  "message": "Fund validation successful",
  "transactionId": "txn-550e8400-e29b-41d4-a716-446655440000"
}

POST

contributions

fund

validate

curl 'https://qa-super.mygigsters.com.au/v1/contributions/fund/validate' -X POST \
    -u "apiUsername:apiPassword"  \
    -H "Content-Type: application/json" --data '{"fundUsis":["40328908469310"]}'

const response = await fetch("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate", {
  method: "POST",
  headers: {
    Authorization: "Basic " + Buffer.from("apiUsername:apiPassword").toString("base64"),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "fundUsis": [
      "40328908469310"
    ]
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://qa-super.mygigsters.com.au/v1/contributions/fund/validate",
    auth=("apiUsername", "apiPassword"),
    json={
        "fundUsis": [
            "40328908469310",
        ],
    },
)

print(response.json())

require "net/http"
require "json"
require "uri"

uri = URI("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate")
request = Net::HTTP::Post.new(uri)
request.basic_auth("apiUsername", "apiPassword")
request["Content-Type"] = "application/json"
request.body = <<~JSON
  {
    "fundUsis": [
      "40328908469310"
    ]
  }
JSON

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

<?php

$ch = curl_init("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate");

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_USERPWD => "apiUsername:apiPassword",
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "fundUsis": [
    "40328908469310"
  ]
}
JSON,
]);

$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;

public class Example {
    public static void main(String[] args) throws Exception {
        String credentials = Base64.getEncoder()
            .encodeToString("apiUsername:apiPassword".getBytes());

        String body = String.join("\n",
            "{",
            "  \"fundUsis\": [",
            "    \"40328908469310\"",
            "  ]",
            "}"
        );

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate"))
            .header("Authorization", "Basic " + credentials)
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "fundUsis": [
    "40328908469310"
  ]
}`)

	req, err := http.NewRequest("POST", "https://qa-super.mygigsters.com.au/v1/contributions/fund/validate", body)
	if err != nil {
		panic(err)
	}
	req.SetBasicAuth("apiUsername", "apiPassword")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Post, "https://qa-super.mygigsters.com.au/v1/contributions/fund/validate");
request.Headers.Authorization = new AuthenticationHeaderValue(
    "Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("apiUsername:apiPassword")));
request.Content = new StringContent(@"{
  ""fundUsis"": [
    ""40328908469310""
  ]
}", Encoding.UTF8, "application/json");

var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

{
  "success": true,
  "statusCode": 200,
  "message": "Fund validation successful",
  "transactionId": "txn-550e8400-e29b-41d4-a716-446655440000"
}

Why it’s useful: Use it to check the USIs your workers have already entered, so you know each fund can receive contributions.

Simplified Request Format

The fund validation endpoint has been simplified to automatically retrieve employer information from the database. You only need to provide the fund USIs you want to validate. Minimal Request (Recommended):

{
  "fundUsis": ["40328908469310"]
}

The system automatically retrieves your employer information based on your authentication credentials, so you no longer need to include employer details in the request.

Transaction ID - Server-Generated

The server automatically generates a unique transaction ID and timestamp for each request. Transaction ID Format: txn-{uuid} Example generated IDs:

txn-550e8400-e29b-41d4-a716-446655440000
txn-6ba7b810-9dad-11d1-80b4-00c04fd430c8

The transaction ID will be:

Included in all response payloads
Available in error messages for troubleshooting
Returned in response headers for request tracking

Transaction ID in Response

The validate fund endpoint returns the server-generated transaction ID in the response:

{
  "success": true,
  "statusCode": 200,
  "message": "Fund validation successful",
  "transactionId": "txn-550e8400-e29b-41d4-a716-446655440000"
}

Use this ID for logging, debugging, and tracking requests in your system.

Validation Checks Performed

USI Format: Verifies the USI follows the correct 14-character format
Fund Active Status: Confirms the fund is currently accepting contributions
Electronic Capability: Verifies the fund can receive SuperStream contributions
Employer Association: Optional check if employer is already registered with the fund

When to Use

Member Onboarding: Validate the fund USI provided by a new employee
Choice of Fund: Verify funds before presenting them to employees
Pre-submission Check: Validate all funds in a batch before submission
Periodic Verification: Funds occasionally change status (mergers, closures)

Common USI Issues

Fund has merged with another fund (will return new USI)
Fund is temporarily not accepting electronic contributions
USI is for a closed or legacy product

Benefits of Simplified Format

Simpler Integration: No need to manage employer details
Smaller Request Payloads: Only send what’s necessary
Always Up-to-Date: Uses the most current employer information from the database
Consistent Data: Same employer data used across all requests

Best Practices

Cache valid USIs for up to 24 hours
Always re-validate before first contribution to a new fund
Handle fund merge redirects gracefully
Use the transaction ID from responses for request tracking

Request Body

array

required

Array of superannuation fund USIs (Unique Superannuation Identifiers) to validate. Each USI will be checked against the active funds registry to ensure it can accept contributions.

Responses

Code	Description
`200`	Fund validation successful. All specified USIs are active and can receive contributions.
`400`	Fund validation failed - One or more USIs are invalid or inactive.
`401`	Unauthorized - Invalid API credentials.
`500`	Internal server error.

Response fields

boolean

Indicates whether the operation completed successfully. True means the validation passed or submission was accepted.

integer

HTTP status code of the response. 200 indicates success.

string

Human-readable message describing the operation result. For successful operations, provides confirmation of what was validated or submitted.

string

Server-generated transaction ID in the format txn-{uuid}. This ID is automatically generated by the server for tracking and correlation purposes. Use this ID for logging, debugging, and tracking requests in your system.

Error response fields

boolean

Always false for error responses, indicating the operation did not succeed.

integer

HTTP status code indicating the type of error. Common values: 400 (Bad Request), 401 (Unauthorized), 404 (Not Found), 500 (Server Error)

string

Human-readable error message explaining what went wrong. May include specific details about which field or value caused the error.

integer

Superannuation clearing house-specific error code for programmatic error handling. Refer to the error code reference documentation for a complete list of codes. Common codes: 4030 (Employer not found), 4031 (Invalid ABN), 4040 (Fund not found).

curl 'https://qa-super.mygigsters.com.au/v1/contributions/fund/validate' -X POST \
    -u "apiUsername:apiPassword"  \
    -H "Content-Type: application/json" --data '{"fundUsis":["40328908469310"]}'

const response = await fetch("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate", {
  method: "POST",
  headers: {
    Authorization: "Basic " + Buffer.from("apiUsername:apiPassword").toString("base64"),
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "fundUsis": [
      "40328908469310"
    ]
  }),
});

const data = await response.json();
console.log(data);

import requests

response = requests.post(
    "https://qa-super.mygigsters.com.au/v1/contributions/fund/validate",
    auth=("apiUsername", "apiPassword"),
    json={
        "fundUsis": [
            "40328908469310",
        ],
    },
)

print(response.json())

require "net/http"
require "json"
require "uri"

uri = URI("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate")
request = Net::HTTP::Post.new(uri)
request.basic_auth("apiUsername", "apiPassword")
request["Content-Type"] = "application/json"
request.body = <<~JSON
  {
    "fundUsis": [
      "40328908469310"
    ]
  }
JSON

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

<?php

$ch = curl_init("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate");

curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => "POST",
    CURLOPT_USERPWD => "apiUsername:apiPassword",
    CURLOPT_HTTPHEADER => [
        "Content-Type: application/json",
    ],
    CURLOPT_POSTFIELDS => <<<'JSON'
{
  "fundUsis": [
    "40328908469310"
  ]
}
JSON,
]);

$response = curl_exec($ch);
curl_close($ch);

print_r(json_decode($response, true));

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.Base64;

public class Example {
    public static void main(String[] args) throws Exception {
        String credentials = Base64.getEncoder()
            .encodeToString("apiUsername:apiPassword".getBytes());

        String body = String.join("\n",
            "{",
            "  \"fundUsis\": [",
            "    \"40328908469310\"",
            "  ]",
            "}"
        );

        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://qa-super.mygigsters.com.au/v1/contributions/fund/validate"))
            .header("Authorization", "Basic " + credentials)
            .header("Content-Type", "application/json")
            .method("POST", HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());

        System.out.println(response.body());
    }
}

package main

import (
	"fmt"
	"io"
	"net/http"
	"strings"
)

func main() {
	body := strings.NewReader(`{
  "fundUsis": [
    "40328908469310"
  ]
}`)

	req, err := http.NewRequest("POST", "https://qa-super.mygigsters.com.au/v1/contributions/fund/validate", body)
	if err != nil {
		panic(err)
	}
	req.SetBasicAuth("apiUsername", "apiPassword")
	req.Header.Set("Content-Type", "application/json")

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	data, _ := io.ReadAll(res.Body)
	fmt.Println(string(data))
}

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();

var request = new HttpRequestMessage(HttpMethod.Post, "https://qa-super.mygigsters.com.au/v1/contributions/fund/validate");
request.Headers.Authorization = new AuthenticationHeaderValue(
    "Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("apiUsername:apiPassword")));
request.Content = new StringContent(@"{
  ""fundUsis"": [
    ""40328908469310""
  ]
}", Encoding.UTF8, "application/json");

var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());

{
  "success": true,
  "statusCode": 200,
  "message": "Fund validation successful",
  "transactionId": "txn-550e8400-e29b-41d4-a716-446655440000"
}

Last modified on November 10, 2026

API keys

Employers

Employees

Member verification

Funds

Contributions

Payment status

Webhooks

Validate superannuation fund

Simplified Request Format

Transaction ID - Server-Generated

Transaction ID in Response

Validation Checks Performed

When to Use

Common USI Issues

Benefits of Simplified Format

Best Practices

Request Body

Responses

Response fields

​Simplified Request Format

​Transaction ID - Server-Generated

​Transaction ID in Response

​Validation Checks Performed

​When to Use

​Common USI Issues

​Benefits of Simplified Format

​Best Practices

​Request Body

​Responses

​Response fields

Simplified Request Format

Transaction ID - Server-Generated

Transaction ID in Response

Validation Checks Performed

When to Use

Common USI Issues

Benefits of Simplified Format

Best Practices

Request Body

Responses

Response fields