Dell warranty
Dell warranty and entitlement lookup by service tag.
| Category | Warranty |
| Authentication | OAuth client credentials |
| Reaches | Dell’s TechDirect API |
| Needs an agent | No |
| Demo mode | Yes |
Capabilities
Section titled “Capabilities”warranty.lookup
Which feeds the coverage shown on a device and recorded against a repair, and therefore cost analytics.
Getting the credentials
Section titled “Getting the credentials”- Sign in to Dell TechDirect with an account enrolled for your school.
- Go to APIs, and request access to the Warranty and Entitlements API if you have not already.
- Once approved, generate an API key and API secret. These are the OAuth client id and secret.
Approval is not instant. Dell reviews API requests, and it typically takes a few business days.
Configuring it in Plugboard
Section titled “Configuring it in Plugboard”Admin, Connectors, Dell warranty, Configure.
Settings
Section titled “Settings”| Field | Default | Value |
|---|---|---|
demoMode | false | Return fixture data instead of calling Dell |
There is no base URL field. The endpoint is fixed.
Credentials
Section titled “Credentials”| Field | Value |
|---|---|
clientId | The TechDirect API key |
clientSecret | The TechDirect API secret |
Save and test.
Service tags, not serial numbers
Section titled “Service tags, not serial numbers”Dell identifies hardware by service tag, a seven-character code, rather than by what other vendors call a serial number.
In practice they are the same thing on Dell hardware and the connector treats the serial on a device record as the service tag. If a lookup fails for a device you know is Dell, check that what is recorded is the service tag rather than an asset tag your school applied.
What it tells you
Section titled “What it tells you”| Field | Notes |
|---|---|
| Warranty expiry | The end of the entitlement period |
| Entitlement type | ProSupport, Basic, Next Business Day and so on |
| Ship date | When Dell shipped it, which sets the warranty start |
Mixed fleets
Section titled “Mixed fleets”A school with Dell laptops and Apple iPads configures both this and Apple GSX. A device’s coverage resolves through whichever vendor’s connector recognises it.
Troubleshooting
Section titled “Troubleshooting”| Symptom | Cause |
|---|---|
401 on test | Wrong key or secret, or API access has not been approved yet |
| Service tag not found | Not a Dell device, or an asset tag is recorded instead of the service tag |
| Rate limited | Dell’s API has quotas. A bulk lookup across a large fleet can hit them |
| Fixture data returned | demoMode is still on |
Alternatives
Section titled “Alternatives”Apple GSX for Apple hardware.