MyLeadTech Answers API
The Answers API from MyLeadTech — 1 operation(s) for answers.
The Answers API from MyLeadTech — 1 operation(s) for answers.
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-answers-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 Answers 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: Answers
paths:
/v1/answers:
post:
summary: Answers
operationId: answer_question
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/AnswerIn'
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/AnswerOut'
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
'504':
description: Generation timed out.
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
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:
- Answers
components:
schemas:
Publication:
properties:
branch:
type: string
title: Branch
snapshot_ref:
type: string
title: Snapshot Ref
type: object
required:
- branch
- snapshot_ref
title: Publication
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
Passage:
properties:
source_id:
type: string
title: Source Id
document_version_id:
type: string
title: Document Version Id
document_type:
anyOf:
- type: string
- type: 'null'
title: Document Type
text:
type: string
title: Text
pages:
items:
type: integer
type: array
title: Pages
printed_label:
anyOf:
- type: string
- type: 'null'
title: Printed Label
applicability:
type: string
enum:
- established
- family_only
- unestablished
title: Applicability
citations:
items:
$ref: '#/components/schemas/Citation'
type: array
title: Citations
rank:
type: integer
title: Rank
context:
anyOf:
- type: string
- type: 'null'
title: Context
truncated:
type: boolean
title: Truncated
default: false
truncation_reason:
anyOf:
- type: string
- type: 'null'
title: Truncation Reason
type: object
required:
- source_id
- document_version_id
- text
- applicability
- rank
title: Passage
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
Claim:
properties:
text:
type: string
title: Text
source_id:
type: string
title: Source Id
page_number:
anyOf:
- type: integer
- type: 'null'
title: Page Number
document_title:
anyOf:
- type: string
- type: 'null'
title: Document Title
citation_window_id:
anyOf:
- type: string
- type: 'null'
title: Citation Window Id
type: object
required:
- text
- source_id
title: Claim
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
AnswerIn:
properties:
question:
type: string
minLength: 1
title: Question
brand:
anyOf:
- type: string
- type: 'null'
title: Brand
model_reference:
anyOf:
- type: string
- type: 'null'
title: Model Reference
fault_code:
anyOf:
- type: string
- type: 'null'
title: Fault Code
context:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Context
language:
type: string
title: Language
default: en-US
limit:
type: integer
maximum: 20.0
minimum: 1.0
title: Limit
default: 5
max_chars:
anyOf:
- type: integer
maximum: 1200.0
minimum: 80.0
- type: 'null'
title: Max Chars
audience:
type: string
enum:
- technician
- homeowner
title: Audience
default: technician
type: object
required:
- question
title: AnswerIn
AnswerOut:
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
answer:
anyOf:
- type: string
- type: 'null'
title: Answer
claims:
items:
$ref: '#/components/schemas/Claim'
type: array
title: Claims
limits:
items:
type: string
type: array
title: Limits
passages:
items:
$ref: '#/components/schemas/Passage'
type: array
title: Passages
clarification:
anyOf:
- $ref: '#/components/schemas/Clarification'
- type: 'null'
next_action:
anyOf:
- type: string
enum:
- answer
- ask_clarification
- abstain
- escalate_to_human
- type: 'null'
title: Next Action
next_action_reason:
anyOf:
- type: string
- type: 'null'
title: Next Action Reason
summary:
anyOf:
- type: string
- type: 'null'
title: Summary
summary_source_ids:
items:
type: string
type: array
title: Summary Source Ids
requires_qualified_technician:
type: boolean
title: Requires Qualified Technician
default: false
type: object
required:
- request_id
- service_revision
- publication
- status
- usage
title: AnswerOut
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