Responses below are examples from the ar-00/1 contract, shortened. They are not live captures.
1. Resolve a model
Turn a nameplate reference into brand and published documents. This call is free.
curl https://api.myleadtech.app/v1/equipment/resolve \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"reference":"27TPA8"}'
{
"contract_version": "ar-00/1",
"status": "covered",
"usage": { "operation": "resolve_equipment", "debited": false },
"coverage": "covered",
"brand": "carrier",
"published_documents": [
{ "document_type": "product_data", "title_hint": "27TPA8 Product Data" },
{ "document_type": "installation", "title_hint": "27TPA8 Installation Instructions" }
]
}
Carrier 27TPA8. Other statuses: family_only, not_covered, ambiguous.
2. Ask about a fault code
Pass fault_code with the question. When the library has no published fault-code facts for the unit, you get an abstention and no charge, not a guess.
curl https://api.myleadtech.app/v1/answers \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"What does this fault code mean?",
"model_reference":"YOUR_MODEL","fault_code":"YOUR_CODE"}'
{
"contract_version": "ar-00/1",
"status": "abstained",
"missing": ["applicable_service_manual"],
"usage": { "operation": "answer", "debited": false },
"answer": "I cannot confirm a root cause from the published installation and product data alone.",
"claims": [],
"limits": [
"No published fault-code facts for this equipment in the current corpus snapshot."
],
"passages": []
}
Contract example of the abstained status. The request is a template: substitute your own model and code.
3. Get a cited answer
Each claim carries a source_id. Fetch the passage with get_hvac_source, or the page with get_hvac_document_page.
curl https://api.myleadtech.app/v1/answers \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"question":"What refrigerant does it use?","model_reference":"27TPA8"}'
{
"contract_version": "ar-00/1",
"status": "ok",
"usage": { "operation": "answer", "debited": true },
"answer": "The 27TPA8 is a Performance Series 2-stage heat pump for R-454B indoor units only.",
"claims": [
{
"text": "Uses Puron Advance (R-454B) refrigerant.",
"source_id": "chunk:1a9595df-e0cb-4dfe-83d8-504e1da1757a"
}
],
"passages": [
{
"source_id": "chunk:1a9595df-e0cb-4dfe-83d8-504e1da1757a",
"document_type": "product_data",
"pages": [1],
"applicability": "established"
}
]
}
Carrier 27TPA8, product data, page 1.