> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mygigsters.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Employer by ID

> Retrieves a single employer record by its ID. Returns the employer's contact information, payment configuration, clearing house onboarding status, and metadata.

### Use Case

* Look up a specific employer's details before submitting contributions
* Check `onboardedAtClearingHouse` to confirm the employer is ready to receive contributions
* Retrieve payment account details for reconciliation

### Request Parameters

**id** `string` *required*

The employer ID

### Responses

| Code | Description |
| - | - |
| `200` | Employer retrieved successfully |
| `401` | Unauthorized - Invalid authentication credentials |
| `404` | Employer not found |

### Response fields

**id** `string`

Employer ID

**name** `string`

Employer business name

**abn** `string`

Australian Business Number (ABN)

**contact** `object`

Employer contact information

**properties**

**name** `object`

Contact person name

**phoneNumber** `object`

Contact phone number

**email** `object`

Contact email address

**clientId** `number`

Client ID associated with this employer

**superApiMeta** `object`

Super API metadata including payment and refund account details

**properties**

**paymentDetails** `object`

Payment configuration for contributions

**refundAccount** `object`

Bank account details for refunds

**onboardedAtClearingHouse** `boolean`

Read-only status set by the system. Indicates whether this employer has been fully onboarded at the superannuation clearing house.

**detailsSyncedAtClearingHouse** `string`

Read-only status set by the system. "NA" means no employer detail updates have been made yet, "false" means updates are pending sync to the clearing house, "true" means the latest updates have been synced.

**detailsSyncedAtClearingHouseAt** `string`

Read-only timestamp set by the system. When the updated employer details were last synced to the clearing house.

**createdAt** `string`

Timestamp when the employer record was created

**updatedAt** `string`

Timestamp when the employer record was last updated

> [accordion] Error response fields
>
> **success** `boolean`
>
> **statusCode** `integer`
>
> **message** `string`

```bash cURL theme={null}
curl 'https://qa-super.mygigsters.com.au/v1/employers/6960d86e466f44ab3f163c66' \
    -u "apiUsername:apiPassword"
```

```javascript Node.js theme={null}
const response = await fetch("https://qa-super.mygigsters.com.au/v1/employers/6960d86e466f44ab3f163c66", {
  method: "GET",
  headers: {
    Authorization: "Basic " + Buffer.from("apiUsername:apiPassword").toString("base64"),
  },
});

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

```python Python theme={null}
import requests

response = requests.get(
    "https://qa-super.mygigsters.com.au/v1/employers/6960d86e466f44ab3f163c66",
    auth=("apiUsername", "apiPassword"),
)

print(response.json())
```

```ruby Ruby theme={null}
require "net/http"
require "json"
require "uri"

uri = URI("https://qa-super.mygigsters.com.au/v1/employers/6960d86e466f44ab3f163c66")
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 PHP theme={null}
<?php

$ch = curl_init("https://qa-super.mygigsters.com.au/v1/employers/6960d86e466f44ab3f163c66");

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));
```

```java Java theme={null}
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/employers/6960d86e466f44ab3f163c66"))
            .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());
    }
}
```

```go Go theme={null}
package main

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

func main() {
	req, err := http.NewRequest("GET", "https://qa-super.mygigsters.com.au/v1/employers/6960d86e466f44ab3f163c66", 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))
}
```

```csharp .NET theme={null}
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/employers/6960d86e466f44ab3f163c66");
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());
```

```json 200 theme={null}
{
  "id": "6960d86e466f44ab3f163c66",
  "name": "Example Marketplace Pty Ltd",
  "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"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.