Skip to content
Vectis
All guides

Connect Dell warranty lookup

Dell's TechDirect API returns warranty end dates and service levels for Dell hardware by service tag. Connect it once and Vectis fills in warranty expiry on every Dell asset, so the asset-lifecycle engine plans refreshes against real manufacturer dates instead of estimates.

What you'll need

  • A Dell TechDirect account — the free Dell portal for organizations that buy or manage Dell hardware, at techdirect.dell.com.
  • An approved API key — a Client ID and Client Secret that Dell issues after you request API access in TechDirect. Dell reviews each request, so this is not instant.

1. Request an API key in TechDirect

  1. Sign in to TechDirect at techdirect.dell.com.
  2. Go to Services → Get support and replace parts → APIs.
  3. Click Request API Key. Dell asks for a few details about how you’ll use the API — choose the warranty / asset-entitlement use case, give a rough estimate of your monthly call volume, and select the product types and regions you manage.
  4. Submit the request. Dell reviews it and typically emails your Client ID and Client Secret within a few business days.
The API uses OAuth 2.0. Vectis exchanges your Client ID and Secret for a short-lived access token on each run and refreshes it automatically — there is nothing to renew by hand. Keep the Client Secret confidential; treat it like a password.

2. Add the credentials to Vectis

  1. Go to Admin → Integrations and click Configure on Dell warranty lookup.
  2. Paste the Client ID and Client Secret from Dell’s email. Credentials are encrypted at rest.
  3. Save and make sure the connector is enabled.

3. Enrich your Dell assets

Open Asset lifecycle → Refresh pipeline and click Enrich warranties. Vectis finds every Dell asset that has a service tag, looks each one up against Dell, and writes the result back:

  • warranty_expiry — the latest-ending entitlement date Dell returns for that service tag.
  • warranty_provider — the service-level description of that entitlement (for example, the support plan tier).
  • warranty_source — set to dell_api so you can tell manufacturer-sourced dates apart from RMM or manual ones.
Only Dell-manufactured assets that have a service number are eligible. Assets from other manufacturers, or Dell devices with no service tag recorded, are skipped — they are not counted as errors.

Common errors

Dell warranty credentials not configured — No credentials are saved, or the connector is disabled. Add your Client ID and Secret under Admin → Integrations and enable the connector.

OAuth token exchange failed — The Client ID or Secret is wrong, or your API key request has not been approved yet. Re-check the values against Dell’s email; if the request is still pending, wait for Dell’s approval before retrying.

Assets reported as “not found” — Dell has no entitlement record for that service tag. This is normal for very old hardware, third-party or refurbished units, and devices whose service tag was entered incorrectly in the source system.

Still stuck?

Email support@mspvectis.com with the error message and we’ll unblock you.

Try Vectis free for 30 days.

Self-serve signup. No card required, cancel anytime. No call required, no demo required, no sales engineer required.
Start free trialSee pricing