Apple GSX
Apple warranty and coverage lookup through Global Service Exchange. Tells you, at the point a device is booked in, whether Apple is going to pay for this.
| Category | Warranty |
| Authentication | API token |
| Reaches | Your GSX API endpoint |
| Needs an agent | No |
| Demo mode | No |
Capabilities
Section titled “Capabilities”warranty.lookup
Which feeds the coverage shown on a device and the coverage recorded against a repair, which in turn feeds cost analytics.
You need a GSX account
Section titled “You need a GSX account”This is the part that takes time, and it is not something Plugboard can shortcut.
GSX access requires an Apple service account: either Apple Authorised Service Provider status, or Self Servicing Account status, which is what most schools with a large Apple fleet hold.
If your school does not have one, talk to your Apple education representative or your reseller. The application involves technician certification and takes weeks rather than days.
Once you have access:
- Sign in to GSX.
- Obtain your ship-to account number. It identifies your service location and your technicians will already know it.
- Generate an API token or activation token for the API.
- Note the API base URL Apple gives you. It differs by region and by account type.
Apple rotates and expires these credentials, and the process for renewing is theirs rather than ours. Diary it.
Configuring it in Plugboard
Section titled “Configuring it in Plugboard”Admin, Connectors, Apple GSX, Configure.
Settings
Section titled “Settings”| Field | Value |
|---|---|
baseUrl | The GSX API base URL Apple gave you |
shipTo | Your GSX ship-to account number |
Credentials
Section titled “Credentials”| Field | Value |
|---|---|
apiToken | The API token or activation token |
Save and test.
What it tells you
Section titled “What it tells you”| Field | Why it matters |
|---|---|
| Warranty expiry | Whether the device is still covered |
| AppleCare status | Whether extended coverage applies |
| Coverage description | What Apple will and will not do |
It changes the conversation at the counter. “This is still under AppleCare, so there is no charge” is a much better first sentence than “we will find out and let you know”.
It also makes your cost analytics honest. A school with no warranty lookup tends to record everything as chargeable and then wonder why the numbers look bad.
GSX against a repair vendor
Section titled “GSX against a repair vendor”Different jobs.
GSX answers “is this covered”. It is a lookup.
CompNow and similar answer “somebody else is doing this repair”. They lodge work and track its status.
Schools that are Self Servicing Accounts often use GSX for the coverage answer and do the work themselves. Schools that send work out use both: GSX to know who pays, the vendor connector to track the job.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Cause |
|---|---|
401 on test | Token expired or wrong. Apple rotates these |
403 | The ship-to account is not authorised for the API, or not for that operation |
| Serial not found | The device is not an Apple product, or the serial was mistyped. GSX is strict |
| Works for some devices, not others | Coverage lookup depends on the device having been sold through a channel GSX knows |
| Endpoint not found | The base URL is region-specific. Confirm with Apple which one your account uses |
Alternatives
Section titled “Alternatives”Dell warranty for Dell hardware. There is no generic warranty connector; each vendor’s entitlement API is its own.