DERATE — truck fault codes

Search DERATE's 56-code heavy-truck library by SPN/FMI, P-code or free text. Returns severity, derates yes/no, meaning, part and estimated part-price range, and the page URL. / Busca en la biblioteca de códigos de DERATE.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "SPN/FMI, P-code or free text."
    },
    "lang": {
      "default": "en",
      "description": "Response language / Idioma: 'en' or 'es'.",
      "type": "string",
      "enum": [
        "en",
        "es"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Safe-to-drive verdict (stop / service_soon / info) for a truck fault code, from DERATE's library only. Unknown codes return 'unknown'. / Veredicto de si es seguro seguir manejando.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "minLength": 2,
      "description": "e.g. 'SPN 3251 FMI 0', '3251/0', 'P20EE'."
    },
    "lang": {
      "default": "en",
      "description": "Response language / Idioma: 'en' or 'es'.",
      "type": "string",
      "enum": [
        "en",
        "es"
      ]
    }
  },
  "required": [
    "code"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

How to check heavy-truck safety recalls (NHTSA-based), with per-make source links for Freightliner, Volvo, Kenworth, Peterbilt, International, Mack and Western Star. / Cómo revisar retiros de seguridad.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Optional free text, e.g. a make.",
      "type": "string"
    },
    "make": {
      "description": "Optional truck make, e.g. 'Volvo'.",
      "type": "string"
    },
    "limit": {
      "description": "Maximum items.",
      "type": "integer",
      "minimum": 1,
      "maximum": 7
    },
    "lang": {
      "default": "en",
      "description": "Response language / Idioma: 'en' or 'es'.",
      "type": "string",
      "enum": [
        "en",
        "es"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

DERATE dataset notes: code count, sources, known gaps, license (CC BY 4.0), how to cite and download URLs. / Notas de calidad, licencia y cómo citar.

{
  "type": "object",
  "properties": {
    "lang": {
      "default": "en",
      "description": "Response language / Idioma: 'en' or 'es'.",
      "type": "string",
      "enum": [
        "en",
        "es"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Look up a diesel truck fault code (J1939 SPN/FMI such as 'SPN 3251 FMI 0', or an OBD-II code such as 'P2002') in DERATE's public fault-code library. Returns what the code means, its severity, whether it is safe to keep driving, probable causes, the recommended tests, and the canonical URL of the public page for that code. Works without any account.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "minLength": 2,
      "description": "The fault code, e.g. 'SPN 3251 FMI 0', '3251/0' or 'P2002'."
    },
    "engine_family": {
      "description": "Optional engine family for context, e.g. 'cummins', 'paccar-mx', 'detroit'.",
      "type": "string"
    },
    "lang": {
      "default": "es",
      "description": "Response language: 'es' (Spanish) or 'en' (English).",
      "type": "string",
      "enum": [
        "es",
        "en"
      ]
    }
  },
  "required": [
    "code"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Explain a diesel truck engine derate or power-loss symptom described in plain language (for example 'DEF light on and truck limited to 55 mph'). Returns the most likely cause, how urgent it is, the immediate action to take, and matching public fault-code pages. This is the free public interpretation; the full guided diagnosis with tests and a work order runs in the DERATE app.

{
  "type": "object",
  "properties": {
    "symptom": {
      "type": "string",
      "minLength": 3,
      "description": "Free-text symptom, warning light or behavior the driver observes."
    },
    "code": {
      "description": "Optional fault code already known (SPN/FMI or OBD-II).",
      "type": "string"
    },
    "engine_family": {
      "description": "Optional engine family, e.g. 'cummins'.",
      "type": "string"
    },
    "lang": {
      "default": "es",
      "description": "Response language: 'es' (Spanish) or 'en' (English).",
      "type": "string",
      "enum": [
        "es",
        "en"
      ]
    }
  },
  "required": [
    "symptom"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Full-text search over DERATE's public diesel truck fault-code library by code, system, dashboard light or symptom words. Returns a list of matching entries with code, title, severity, system and the canonical public URL.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Code or free text to search for."
    },
    "severity": {
      "description": "Optional severity filter: RED stop now, YELLOW caution, WHITE info only.",
      "type": "string",
      "enum": [
        "RED",
        "YELLOW",
        "WHITE"
      ]
    },
    "limit": {
      "default": 10,
      "description": "Maximum results.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "lang": {
      "default": "es",
      "description": "Response language: 'es' (Spanish) or 'en' (English).",
      "type": "string",
      "enum": [
        "es",
        "en"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the diesel truck engine families and code protocols DERATE interprets (J1939 SPN/FMI and OBD-II), so an agent knows whether a given truck is covered before looking up a code.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List DERATE's plans and prices in USD. The app is a free download; plans are purchased inside the iOS/Android app (App Store / Google Play). Monthly Driver and Shop plans include a 7-day free trial for new subscribers.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the official App Store and Google Play links for the DERATE native app (iOS and Android). DERATE runs only as a mobile app.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Return the full DERATE demo diagnosis for a truck: verdict (STOP/CAUTION/CLEAR), derate countdown, every fault code and the work order summary.

{
  "type": "object",
  "properties": {
    "lang": {
      "default": "es",
      "description": "Language of the diagnosis text: 'es' (Spanish) or 'en' (English).",
      "type": "string",
      "enum": [
        "es",
        "en"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List the fault codes (SPN/FMI) in the current DERATE diagnosis with severity, system, fault type and whether they are a root cause.

{
  "type": "object",
  "properties": {
    "lang": {
      "default": "es",
      "description": "Language of the labels: 'es' or 'en'.",
      "type": "string",
      "enum": [
        "es",
        "en"
      ]
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Explain a truck fault code or symptom in DERATE terms: plain-language meaning, severity, probable causes, recommended tests with expected values, repair steps and cost estimate.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "Fault code (e.g. 'SPN 3251 FMI 0'), system name or symptom text to look up."
    },
    "lang": {
      "default": "es",
      "description": "Language of the explanation: 'es' or 'en'.",
      "type": "string",
      "enum": [
        "es",
        "en"
      ]
    }
  },
  "required": [
    "query"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}