curl 'https://qa-super.mygigsters.com.au/v1/clients/me/employers' \
-u "apiUsername:apiPassword"
const response = await fetch("https://qa-super.mygigsters.com.au/v1/clients/me/employers", {
method: "GET",
headers: {
Authorization: "Basic " + Buffer.from("apiUsername:apiPassword").toString("base64"),
},
});
const data = await response.json();
console.log(data);
import requests
response = requests.get(
"https://qa-super.mygigsters.com.au/v1/clients/me/employers",
auth=("apiUsername", "apiPassword"),
)
print(response.json())
require "net/http"
require "json"
require "uri"
uri = URI("https://qa-super.mygigsters.com.au/v1/clients/me/employers")
request = Net::HTTP::Get.new(uri)
request.basic_auth("apiUsername", "apiPassword")
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/clients/me/employers");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_USERPWD => "apiUsername:apiPassword",
]);
$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());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://qa-super.mygigsters.com.au/v1/clients/me/employers"))
.header("Authorization", "Basic " + credentials)
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://qa-super.mygigsters.com.au/v1/clients/me/employers", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth("apiUsername", "apiPassword")
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.Get, "https://qa-super.mygigsters.com.au/v1/clients/me/employers");
request.Headers.Authorization = new AuthenticationHeaderValue(
"Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("apiUsername:apiPassword")));
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
{
"employers": [
{
"id": "6960d86e466f44ab3f163c66",
"name": "Example Marketplace Pty Ltd 2.0",
"abn": "34623710896",
"contact": {
"name": {
"title": "Mr",
"firstName": "Test",
"middleName": " ",
"lastName": "User",
"suffix": " "
},
"phoneNumber": {
"type": "MOBILE_PHONE",
"value": "0412345678"
},
"email": {
"value": "accounts@example.com"
}
},
"clientId": 2,
"superApiMeta": {
"paymentDetails": {
"paymentType": "DIRECTDEBIT",
"directDebit": {
"bankAccount": {
"accountName": "Example Marketplace Pty Ltd",
"bsb": "123456",
"accountNumber": "12345678"
},
"directDebitPaymentAmount": {
"value": 0,
"currency": "AUD"
}
}
},
"refundAccount": {
"accountName": "Example Marketplace Pty Ltd",
"bsb": "123456",
"accountNumber": "12345678"
}
},
"onboardedAtClearingHouse": true,
"detailsSyncedAtClearingHouse": "NA",
"createdAt": "2025-12-19T06:50:36.275Z",
"updatedAt": "2025-12-19T06:50:36.275Z"
}
],
"total": 1
}
Employers
List Client Employers
Retrieves all employers associated with the authenticated client. Returns a list of employer records with their contact information, payment details, and metadata.
GET
/
v1
/
clients
/
me
/
employers
curl 'https://qa-super.mygigsters.com.au/v1/clients/me/employers' \
-u "apiUsername:apiPassword"
const response = await fetch("https://qa-super.mygigsters.com.au/v1/clients/me/employers", {
method: "GET",
headers: {
Authorization: "Basic " + Buffer.from("apiUsername:apiPassword").toString("base64"),
},
});
const data = await response.json();
console.log(data);
import requests
response = requests.get(
"https://qa-super.mygigsters.com.au/v1/clients/me/employers",
auth=("apiUsername", "apiPassword"),
)
print(response.json())
require "net/http"
require "json"
require "uri"
uri = URI("https://qa-super.mygigsters.com.au/v1/clients/me/employers")
request = Net::HTTP::Get.new(uri)
request.basic_auth("apiUsername", "apiPassword")
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/clients/me/employers");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_USERPWD => "apiUsername:apiPassword",
]);
$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());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://qa-super.mygigsters.com.au/v1/clients/me/employers"))
.header("Authorization", "Basic " + credentials)
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://qa-super.mygigsters.com.au/v1/clients/me/employers", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth("apiUsername", "apiPassword")
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.Get, "https://qa-super.mygigsters.com.au/v1/clients/me/employers");
request.Headers.Authorization = new AuthenticationHeaderValue(
"Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("apiUsername:apiPassword")));
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
{
"employers": [
{
"id": "6960d86e466f44ab3f163c66",
"name": "Example Marketplace Pty Ltd 2.0",
"abn": "34623710896",
"contact": {
"name": {
"title": "Mr",
"firstName": "Test",
"middleName": " ",
"lastName": "User",
"suffix": " "
},
"phoneNumber": {
"type": "MOBILE_PHONE",
"value": "0412345678"
},
"email": {
"value": "accounts@example.com"
}
},
"clientId": 2,
"superApiMeta": {
"paymentDetails": {
"paymentType": "DIRECTDEBIT",
"directDebit": {
"bankAccount": {
"accountName": "Example Marketplace Pty Ltd",
"bsb": "123456",
"accountNumber": "12345678"
},
"directDebitPaymentAmount": {
"value": 0,
"currency": "AUD"
}
}
},
"refundAccount": {
"accountName": "Example Marketplace Pty Ltd",
"bsb": "123456",
"accountNumber": "12345678"
}
},
"onboardedAtClearingHouse": true,
"detailsSyncedAtClearingHouse": "NA",
"createdAt": "2025-12-19T06:50:36.275Z",
"updatedAt": "2025-12-19T06:50:36.275Z"
}
],
"total": 1
}
Use Case
- Display list of employers for the client
- View employer details and payment configuration
- Manage multiple employers under a single client account
Responses
| Code | Description |
|---|---|
200 | List of employers retrieved successfully |
401 | Unauthorized - Invalid authentication credentials |
404 | Client not found |
500 | Internal server error - An unexpected error occurred. If this persists, contact support. |
Response fields
array
List of employers associated with the authenticated client. Each employer includes contact information, payment details, and metadata.
number
Total number of employers associated with the client
Error response fields
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.
curl 'https://qa-super.mygigsters.com.au/v1/clients/me/employers' \
-u "apiUsername:apiPassword"
const response = await fetch("https://qa-super.mygigsters.com.au/v1/clients/me/employers", {
method: "GET",
headers: {
Authorization: "Basic " + Buffer.from("apiUsername:apiPassword").toString("base64"),
},
});
const data = await response.json();
console.log(data);
import requests
response = requests.get(
"https://qa-super.mygigsters.com.au/v1/clients/me/employers",
auth=("apiUsername", "apiPassword"),
)
print(response.json())
require "net/http"
require "json"
require "uri"
uri = URI("https://qa-super.mygigsters.com.au/v1/clients/me/employers")
request = Net::HTTP::Get.new(uri)
request.basic_auth("apiUsername", "apiPassword")
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/clients/me/employers");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_USERPWD => "apiUsername:apiPassword",
]);
$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());
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://qa-super.mygigsters.com.au/v1/clients/me/employers"))
.header("Authorization", "Basic " + credentials)
.method("GET", HttpRequest.BodyPublishers.noBody())
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}
package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, err := http.NewRequest("GET", "https://qa-super.mygigsters.com.au/v1/clients/me/employers", nil)
if err != nil {
panic(err)
}
req.SetBasicAuth("apiUsername", "apiPassword")
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.Get, "https://qa-super.mygigsters.com.au/v1/clients/me/employers");
request.Headers.Authorization = new AuthenticationHeaderValue(
"Basic", Convert.ToBase64String(Encoding.UTF8.GetBytes("apiUsername:apiPassword")));
var response = await client.SendAsync(request);
Console.WriteLine(await response.Content.ReadAsStringAsync());
{
"employers": [
{
"id": "6960d86e466f44ab3f163c66",
"name": "Example Marketplace Pty Ltd 2.0",
"abn": "34623710896",
"contact": {
"name": {
"title": "Mr",
"firstName": "Test",
"middleName": " ",
"lastName": "User",
"suffix": " "
},
"phoneNumber": {
"type": "MOBILE_PHONE",
"value": "0412345678"
},
"email": {
"value": "accounts@example.com"
}
},
"clientId": 2,
"superApiMeta": {
"paymentDetails": {
"paymentType": "DIRECTDEBIT",
"directDebit": {
"bankAccount": {
"accountName": "Example Marketplace Pty Ltd",
"bsb": "123456",
"accountNumber": "12345678"
},
"directDebitPaymentAmount": {
"value": 0,
"currency": "AUD"
}
}
},
"refundAccount": {
"accountName": "Example Marketplace Pty Ltd",
"bsb": "123456",
"accountNumber": "12345678"
}
},
"onboardedAtClearingHouse": true,
"detailsSyncedAtClearingHouse": "NA",
"createdAt": "2025-12-19T06:50:36.275Z",
"updatedAt": "2025-12-19T06:50:36.275Z"
}
],
"total": 1
}
Last modified on November 10, 2026
Was this page helpful?