MyLeadTech Fault Codes API
The Fault Codes API from MyLeadTech — 1 operation(s) for fault codes.
The Fault Codes API from MyLeadTech — 1 operation(s) for fault codes.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/myleadtech-app:myleadtech-app-fault-codes-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: MyLeadTech Fault Codes API
description: 'HVAC service-manual API: resolve a model or nameplate reference, search OEM manuals, get fault-code meanings and answers cited to the manual page they came from. Authenticate with `Authorization: Bearer ` (keys at https://web.myleadtech.app). Docs: https://myleadtech.app/developers/docs'
termsOfService: https://myleadtech.app/terms
contact:
name: MyLeadTech
url: https://myleadtech.app/developers
email: hello@myleadtech.app
version: ar-00/1
servers:
- url: https://api.myleadtech.app
description: Production
tags:
- name: Fault Codes
paths:
/v1/fault-codes/lookup:
post:
summary: Lookup Fault Code
description: 'Meaning of a published fault code, quoted verbatim from the OEM manual (no generation).
Billed: 1 unit when status is ok. A missing brand returns a clarification; an unpublished code returns
`empty`; neither is billed.'
operationId: lookup_fault_code
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/FaultCodeIn'
required: true
responses:
'200':
description: 'Billed: 1 unit when status is ok (answers: 1 unit only when at least one claim rests on a source established for the equipment; an ok answer from documentation not confirmed for the unit is not billed, see usage.debited).'
content:
application/json:
schema:
$ref: '#/components/schemas/FaultCodeOut'
headers:
X-Request-Id:
description: Identifier of this call; the same value is in the body and in the service log.
schema:
type: string
MLT-Contract:
description: Contract version served (additive changes keep it).
schema:
type: string
X-MLT-Units-Remaining:
description: Units left in the current window (when the ledger is active).
schema:
type: number
X-MLT-Units-Reset:
description: End of the current window (ISO 8601).
schema:
type: string
'400':
description: 'Invalid request: `error.param` names the parameter to fix.'
content:
application/json:
schema:
$ref: '#/components/schemas/ErreurOut'
headers:
X-Request-Id:
description: Identifier of this call; the same value is in the body and in the service log.
schema:
type: string
MLT-Contract:
description: Contract version served (additive changes keep it).
schema:
type: string
'401':
description: Credential is missing or invalid.
content:
application/json:
schema:
$ref: '#/components/schemas/ErreurOut'
headers:
X-Request-Id:
description: Identifier of this call; the same value is in the body and in the service log.
schema:
type: string
MLT-Contract:
description: Contract version served (additive changes keep it).
schema:
type: string
'403':
description: The credential does not allow this operation.
content:
application/json:
schema:
$ref: '#/components/schemas/ErreurOut'
headers:
X-Request-Id:
description: Identifier of this call; the same value is in the body and in the service log.
schema:
type: string
MLT-Contract:
description: Contract version served (additive changes keep it).
schema:
type: string
'409':
description: Idempotency-Key reused with a different request, or operation already submitted.
content:
application/json:
schema:
$ref: '#/components/schemas/ErreurOut'
headers:
X-Request-Id:
description: Identifier of this call; the same value is in the body and in the service log.
schema:
type: string
MLT-Contract:
description: Contract version served (additive changes keep it).
schema:
type: string
'429':
description: Rate limit or monthly allowance reached; see `Retry-After`.
content:
application/json:
schema:
$ref: '#/components/schemas/ErreurOut'
headers:
X-Request-Id:
description: Identifier of this call; the same value is in the body and in the service log.
schema:
type: string
MLT-Contract:
description: Contract version served (additive changes keep it).
schema:
type: string
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
'503':
description: Dependency unavailable; see `Retry-After`.
content:
application/json:
schema:
$ref: '#/components/schemas/ErreurOut'
headers:
X-Request-Id:
description: Identifier of this call; the same value is in the body and in the service log.
schema:
type: string
MLT-Contract:
description: Contract version served (additive changes keep it).
schema:
type: string
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
minimum: 1
security:
- bearerAuth: []
parameters:
- name: Idempotency-Key
in: header
required: false
description: Replays the same result without a second debit (kept 7 days). Max 200 characters.
schema:
type: string
maxLength: 200
tags:
- Fault Codes
components:
schemas:
Publication:
properties:
branch:
type: string
title: Branch
snapshot_ref:
type: string
title: Snapshot Ref
type: object
required:
- branch
- snapshot_ref
title: Publication
FaultCodeOut:
properties:
request_id:
type: string
title: Request Id
contract_version:
type: string
title: Contract Version
default: ar-00/1
service_revision:
type: string
title: Service Revision
publication:
$ref: '#/components/schemas/Publication'
status:
type: string
title: Status
partial:
type: boolean
title: Partial
default: false
missing:
items:
type: string
type: array
title: Missing
degraded:
items:
type: string
type: array
title: Degraded
usage:
$ref: '#/components/schemas/CatalogUsage'
notice:
anyOf:
- type: string
- type: 'null'
title: Notice
code:
type: string
title: Code
verbatim:
anyOf:
- type: string
- type: 'null'
title: Verbatim
value:
anyOf:
- type: string
- type: 'null'
title: Value
unit:
anyOf:
- type: string
- type: 'null'
title: Unit
applies_to:
items:
type: string
type: array
title: Applies To
source_id:
anyOf:
- type: string
- type: 'null'
title: Source Id
document_version_id:
anyOf:
- type: string
- type: 'null'
title: Document Version Id
page_number:
anyOf:
- type: integer
- type: 'null'
title: Page Number
citations:
items:
$ref: '#/components/schemas/Citation'
type: array
title: Citations
clarification:
anyOf:
- $ref: '#/components/schemas/Clarification'
- type: 'null'
type: object
required:
- request_id
- service_revision
- publication
- status
- usage
- code
title: FaultCodeOut
description: 'Verbatim publié seulement : aucune génération.'
Citation:
properties:
citation_window_id:
type: string
title: Citation Window Id
page_number:
type: integer
title: Page Number
box:
anyOf:
- $ref: '#/components/schemas/Boite'
- type: 'null'
page_actions:
$ref: '#/components/schemas/PageActions'
type: object
required:
- citation_window_id
- page_number
- page_actions
title: Citation
ClarificationChoice:
properties:
id:
type: string
title: Id
label:
type: string
title: Label
type: object
required:
- id
- label
title: ClarificationChoice
Boite:
properties:
x0:
type: number
title: X0
y0:
type: number
title: Y0
x1:
type: number
title: X1
y1:
type: number
title: Y1
type: object
required:
- x0
- y0
- x1
- y1
title: Boite
PageActions:
properties:
rest_path:
type: string
title: Rest Path
default_format:
type: string
title: Default Format
default: png
type: object
required:
- rest_path
title: PageActions
FaultCodeIn:
properties:
brand:
anyOf:
- type: string
- type: 'null'
title: Brand
model_reference:
anyOf:
- type: string
- type: 'null'
title: Model Reference
code:
type: string
maxLength: 40
minLength: 1
title: Code
language:
type: string
title: Language
default: en-US
type: object
required:
- code
title: FaultCodeIn
Erreur:
properties:
code:
type: string
title: Code
message:
type: string
title: Message
param:
anyOf:
- type: string
- type: 'null'
title: Param
doc_url:
anyOf:
- type: string
- type: 'null'
title: Doc Url
retry_after_seconds:
anyOf:
- type: integer
- type: 'null'
title: Retry After Seconds
type: object
required:
- code
- message
title: Erreur
ErreurOut:
properties:
request_id:
type: string
title: Request Id
contract_version:
type: string
title: Contract Version
default: ar-00/1
error:
$ref: '#/components/schemas/Erreur'
type: object
required:
- request_id
- error
title: ErreurOut
CatalogUsage:
properties:
operation:
type: string
title: Operation
debited:
type: boolean
title: Debited
units:
anyOf:
- type: number
- type: 'null'
title: Units
remaining:
anyOf:
- type: number
- type: 'null'
title: Remaining
window_end:
anyOf:
- type: string
- type: 'null'
title: Window End
type: object
required:
- operation
- debited
title: CatalogUsage
Clarification:
properties:
question:
type: string
title: Question
options:
anyOf:
- items:
type: string
type: array
- type: 'null'
title: Options
field:
anyOf:
- type: string
- type: 'null'
title: Field
reason_code:
anyOf:
- type: string
- type: 'null'
title: Reason Code
choices:
anyOf:
- items:
$ref: '#/components/schemas/ClarificationChoice'
type: array
maxItems: 5
- type: 'null'
title: Choices
type: object
required:
- question
title: Clarification
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: MyLeadTech API key from https://web.myleadtech.app