{
"error": {
"code": "STALE_REVISION",
"message": "The visit changed; read it again before editing",
"request_id": "example-request",
"details": []
}
}
Installed items at owned locations, with recorded condition, lifecycle dates, warranty terms, and optional same-location HVAC grouping. All operational statuses are included by default. No inferred age, warranty eligibility, or item service history.
{
"error": {
"code": "STALE_REVISION",
"message": "The visit changed; read it again before editing",
"request_id": "example-request",
"details": []
}
}
Generation time and company timezone. generated_at is not a snapshot or synchronization token.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Breezy FSM API","description":"Build operational and financial reports with the Breezy field service management API.","colors":{"primary":"#0958D9","light":"#4096FF","dark":"#0958D9"},"logo":{"light":"https://mintcdn.com/breezy-fsm/oiZqxfHjJWgR4SxV/logo/breezy-light.svg?fit=max\u0026auto=format\u0026n=oiZqxfHjJWgR4SxV\u0026q=85\u0026s=0d4ab09c4ec7a4400a349d0f2977aab8","dark":"https://mintcdn.com/breezy-fsm/oiZqxfHjJWgR4SxV/logo/breezy-dark.svg?fit=max\u0026auto=format\u0026n=oiZqxfHjJWgR4SxV\u0026q=85\u0026s=4321d61497647cf95bd6a5699e865094"},"favicon":"https://mintcdn.com/breezy-fsm/oiZqxfHjJWgR4SxV/favicon.png?fit=max\u0026auto=format\u0026n=oiZqxfHjJWgR4SxV\u0026q=85\u0026s=b8d4bc0727520f5ee0ddbada48d37ce4","api":{"playground":{"display":"interactive","proxy":false,"credentials":false},"examples":{"defaults":"required","languages":["curl","python","javascript"],"prefill":false}},"appearance":{"default":"system","strict":false},"navbar":{"links":[{"href":"https://getbreezyapp.com","label":"Breezy"}],"primary":{"type":"button","label":"Open FSM","href":"https://dashboard.getbreezyapp.com"}},"seo":{"metatags":{"og:title":"Breezy FSM API","og:description":"Scheduling and operational and financial reporting: resources, pagination, business measures, and examples.","og:type":"website","twitter:card":"summary_large_image"},"indexing":"navigable"},"fonts":{"heading":{"family":"Poppins","weight":600}},"icons":{"library":"lucide"},"styling":{"codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"breezy-fsm","hasAudioNarration":false,"actualSubdomain":"breezy-fsm","customDomains":["developers.getbreezyapp.com"],"gitSource":{"type":"github","owner":"breezy-software-inc","repo":"platform","deployBranch":"public-api-docs","contentDirectory":"docs/public-api","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ab55e44a89dca91c2c0530c","collectionId":"ef0d6133-1f75-47c3-a721-8ee620608de6","liveDeploymentHistoryId":"6ab55e44a89dca91c2c0530c","schemaVersion":"v3"},"entitlements":{},"buildId":"6ab55e44a89dca91c2c0530c","clientVersion":"0.0.3965","searchFilterCounts":[{"language":"default","tag":"API reference","count":64},{"language":"default","tag":"Reporting guides","count":11},{"language":"default","tag":"Business measures","count":9},{"language":"default","tag":"Scheduling","count":9},{"language":"default","tag":"Start here","count":6},{"language":"default","tag":"Get started","count":6},{"language":"default","tag":"Reports","count":6},{"language":"default","tag":"Plan your reports","count":2},{"language":"default","tag":"Accounts","count":2},{"language":"default","tag":"BusinessUnits","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"isAtlas":false,"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"api-reference/equipment/read-one-equipment","slug":"/api-reference/equipment/read-one-equipment","pageMetadata":{"title":"Read one equipment","description":"Installed items at owned locations, with recorded condition, lifecycle dates, warranty terms, and optional same-location HVAC grouping. All operational statuses are included by default. No inferred age, warranty eligibility, or item service history.","deprecated":null,"version":null,"openapi":"/openapi.json get /equipment/{id}","href":"/api-reference/equipment/read-one-equipment","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Installed items at owned locations, with recorded condition, lifecycle dates, warranty terms, and optional same-location HVAC grouping. All operational statuses are included by default. No inferred age, warranty eligibility, or item service history.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Read one equipment","description":"Installed items at owned locations, with recorded condition, lifecycle dates, warranty terms, and optional same-location HVAC grouping. All operational statuses are included by default. No inferred age, warranty eligibility, or item service history.","deprecated":null,"version":null,"openapi":"/openapi.json get /equipment/{id}","href":"/api-reference/equipment/read-one-equipment","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getEquipment","tags":["Equipment"],"summary":"Read one equipment","description":"Installed items at owned locations, with recorded condition, lifecycle dates, warranty terms, and optional same-location HVAC grouping. All operational statuses are included by default. No inferred age, warranty eligibility, or item service history.","security":["91213982-be4d-405f-a0c8-b0a290a8cd6c"],"parameters":["92de2ad8-fd18-4743-9736-44884352d999"],"responses":{"200":"40c659c3-4918-4707-8aaa-f9b82228fa85","400":"bcb17719-3d28-4062-9c5d-6839e23c86c4","401":"5710726e-84da-458b-9d67-25fe8d6c2efc","404":"3284dfbe-aefb-45d5-9b7c-6b273d99cff5","405":"6d44d834-9332-4f0a-ac64-59902465c739","409":"d45c5355-3f86-43df-b943-7025a6c487f1","413":"97abfc73-318a-431c-aec0-8d0052c13f7b","429":"67b04a21-1b8f-4788-a9dd-820bcb3eca3a","500":"d6aa6226-274b-4fde-a6c4-64074226c379"},"method":"get","type":"path","servers":["d4239c0d-e8dd-49f6-b7f4-2b5a3ad6583c"],"path":"/equipment/{id}","baseUrlOptions":["https://api.getbreezyapp.com/v1"],"title":"Read one equipment","codeSamples":[],"requestExampleLanguages":["bash","python","javascript"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"92de2ad8-fd18-4743-9736-44884352d999":{"schema":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"","typeLabel":"string\u003cuuid>"},"required":true,"name":"id","in":"path"}},"responses":{"40c659c3-4918-4707-8aaa-f9b82228fa85":{"description":"Successful read. Clients ignore unrecognized response fields.","headers":{"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"}},"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.id","typeLabel":"string\u003cuuid>"},"location_id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.location_id","typeLabel":"string\u003cuuid>"},"hvac_system":{"oneOf":[{"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"data.hvac_system.oneOf.0.id","typeLabel":"string\u003cuuid>"},"name":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.hvac_system.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.hvac_system.oneOf.0.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.hvac_system.oneOf.0.name","typeLabel":"string | null"}},"required":["id","name"],"description":"Current HVAC grouping at this same location.","isRequired":true,"uniqueKey":"data.hvac_system.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"id":{"type":"string","format":"uuid"},"name":{"oneOf":[{"type":"string"},{"type":"null"}]}},"required":["id","name"],"description":"Current HVAC grouping at this same location.","isRequired":true,"uniqueKey":"data.hvac_system.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.hvac_system","typeLabel":"object | null"},"equipment_type":{"type":"string","description":"Recorded type code, including legacy or custom values.","isRequired":true,"uniqueKey":"data.equipment_type","typeLabel":"string"},"status":{"type":"string","description":"Recorded operational status; usual values are IN_SERVICE, DEACTIVATED, and UNKNOWN.","isRequired":true,"uniqueKey":"data.status","typeLabel":"string"},"condition":{"oneOf":[{"type":"string","description":"Recorded condition; not an inferred replacement probability.","isRequired":true,"uniqueKey":"data.condition.oneOf.0","typeLabel":"string"},{"type":"null","description":"Recorded condition; not an inferred replacement probability.","isRequired":true,"uniqueKey":"data.condition.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.condition","typeLabel":"string | null"},"manufacturer":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.manufacturer.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.manufacturer.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.manufacturer","typeLabel":"string | null"},"model_number":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.model_number.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.model_number.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.model_number","typeLabel":"string | null"},"serial_number":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.serial_number.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.serial_number.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.serial_number","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.description.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.description","typeLabel":"string | null"},"dimensions":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.dimensions.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.dimensions.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.dimensions","typeLabel":"string | null"},"manufacturing_date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"data.manufacturing_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"data.manufacturing_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.manufacturing_date","typeLabel":"string\u003cdate> | null"},"installation":{"type":"object","properties":{"date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"data.installation.date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"data.installation.date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.installation.date","typeLabel":"string\u003cdate> | null"},"party":{"oneOf":[{"type":"string","description":"Recorded INTERNAL or EXTERNAL installation, including legacy values.","isRequired":true,"uniqueKey":"data.installation.party.oneOf.0","typeLabel":"string"},{"type":"null","description":"Recorded INTERNAL or EXTERNAL installation, including legacy values.","isRequired":true,"uniqueKey":"data.installation.party.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.installation.party","typeLabel":"string | null"}},"required":["date","party"],"isRequired":true,"uniqueKey":"data.installation","typeLabel":"object"},"estimated_end_of_life_date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"data.estimated_end_of_life_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"data.estimated_end_of_life_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.estimated_end_of_life_date","typeLabel":"string\u003cdate> | null"},"average_life_expectancy_years":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"data.average_life_expectancy_years.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"data.average_life_expectancy_years.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.average_life_expectancy_years","typeLabel":"number | null"},"manufacturer_warranty":{"type":"object","properties":{"start_date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"data.manufacturer_warranty.start_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"data.manufacturer_warranty.start_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.manufacturer_warranty.start_date","typeLabel":"string\u003cdate> | null"},"end_date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"data.manufacturer_warranty.end_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"data.manufacturer_warranty.end_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.manufacturer_warranty.end_date","typeLabel":"string\u003cdate> | null"},"terms":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.manufacturer_warranty.terms.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.manufacturer_warranty.terms.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.manufacturer_warranty.terms","typeLabel":"string | null"}},"required":["start_date","end_date","terms"],"isRequired":true,"uniqueKey":"data.manufacturer_warranty","typeLabel":"object"},"labor_warranty":{"type":"object","properties":{"start_date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"data.labor_warranty.start_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"data.labor_warranty.start_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.labor_warranty.start_date","typeLabel":"string\u003cdate> | null"},"end_date":{"oneOf":[{"type":"string","format":"date","isRequired":true,"uniqueKey":"data.labor_warranty.end_date.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","format":"date","isRequired":true,"uniqueKey":"data.labor_warranty.end_date.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.labor_warranty.end_date","typeLabel":"string\u003cdate> | null"},"terms":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"data.labor_warranty.terms.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"data.labor_warranty.terms.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.labor_warranty.terms","typeLabel":"string | null"}},"required":["start_date","end_date","terms"],"isRequired":true,"uniqueKey":"data.labor_warranty","typeLabel":"object"},"created_at":{"oneOf":[{"type":"string","format":"date-time","description":"Recorded creation time; unavailable on some legacy equipment.","isRequired":true,"uniqueKey":"data.created_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Recorded creation time; unavailable on some legacy equipment.","isRequired":true,"uniqueKey":"data.created_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.created_at","typeLabel":"string\u003cdate-time> | null"},"updated_at":{"oneOf":[{"type":"string","format":"date-time","description":"Equipment-row change only; related system and location changes may not advance it.","isRequired":true,"uniqueKey":"data.updated_at.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","description":"Equipment-row change only; related system and location changes may not advance it.","isRequired":true,"uniqueKey":"data.updated_at.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"data.updated_at","typeLabel":"string\u003cdate-time> | null"}},"required":["id","location_id","hvac_system","equipment_type","status","condition","manufacturer","model_number","serial_number","description","dimensions","manufacturing_date","installation","estimated_end_of_life_date","average_life_expectancy_years","manufacturer_warranty","labor_warranty","created_at","updated_at"],"description":"One installed item at a service location. Dates and warranty terms are recorded inputs, not calculated age, warranty eligibility, or service history.","isRequired":true,"uniqueKey":"data","typeLabel":"object"},"meta":{"type":"object","properties":{"request_id":{"type":"string","isRequired":true,"uniqueKey":"meta.request_id","typeLabel":"string"},"generated_at":{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"meta.generated_at","typeLabel":"string\u003cdate-time>"},"timezone":{"type":"string","isRequired":true,"uniqueKey":"meta.timezone","typeLabel":"string"}},"required":["request_id","generated_at","timezone"],"description":"Generation time and company timezone. generated_at is not a snapshot or synchronization token.","isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["data","meta"],"uniqueKey":"","typeLabel":"object"},"example":{"data":{"id":"11111111-1111-4111-8111-000000004101","location_id":"11111111-1111-4111-8111-000000001107","hvac_system":{"id":"11111111-1111-4111-8111-000000004102","name":"Downstairs"},"equipment_type":"AIR_CONDITIONER","status":"IN_SERVICE","condition":"FAIR","manufacturer":"Example Equipment","model_number":"AC-36","serial_number":"EXAMPLE-001","description":"Outdoor condenser","dimensions":"36 × 36 × 40 inches","manufacturing_date":"2014-01-01","installation":{"date":"2014-06-15","party":"EXTERNAL"},"estimated_end_of_life_date":"2029-06-15","average_life_expectancy_years":15,"manufacturer_warranty":{"start_date":"2014-06-15","end_date":"2024-06-15","terms":"Recorded ten-year limited parts warranty"},"labor_warranty":{"start_date":null,"end_date":null,"terms":null},"created_at":null,"updated_at":"2026-09-08T19:00:00Z"},"meta":{"request_id":"11111111-1111-4111-8111-000000009999","generated_at":"2026-09-08T19:00:00Z","timezone":"America/Los_Angeles"}},"examples":{"Example":{"title":"Example","value":{"data":{"id":"11111111-1111-4111-8111-000000004101","location_id":"11111111-1111-4111-8111-000000001107","hvac_system":{"id":"11111111-1111-4111-8111-000000004102","name":"Downstairs"},"equipment_type":"AIR_CONDITIONER","status":"IN_SERVICE","condition":"FAIR","manufacturer":"Example Equipment","model_number":"AC-36","serial_number":"EXAMPLE-001","description":"Outdoor condenser","dimensions":"36 × 36 × 40 inches","manufacturing_date":"2014-01-01","installation":{"date":"2014-06-15","party":"EXTERNAL"},"estimated_end_of_life_date":"2029-06-15","average_life_expectancy_years":15,"manufacturer_warranty":{"start_date":"2014-06-15","end_date":"2024-06-15","terms":"Recorded ten-year limited parts warranty"},"labor_warranty":{"start_date":null,"end_date":null,"terms":null},"created_at":null,"updated_at":"2026-09-08T19:00:00Z"},"meta":{"request_id":"11111111-1111-4111-8111-000000009999","generated_at":"2026-09-08T19:00:00Z","timezone":"America/Los_Angeles"}}}},"exampleType":"examples"}},"exampleType":"examples"},"bcb17719-3d28-4062-9c5d-6839e23c86c4":{"description":"Malformed input, unknown query parameter, unsupported combination or invalid cursor.","headers":{"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_CURSOR","SCHEDULE_TOO_LARGE","INVALID_SCHEDULE_EVENT","SCHEDULE_CONFLICT","STALE_REVISION","IDEMPOTENCY_CONFLICT","UNAUTHENTICATED","NOT_FOUND","METHOD_NOT_ALLOWED","RATE_LIMITED","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message","request_id","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"INVALID_REQUEST","message":"end_date must be later than start_date","request_id":"example-request","details":[]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_REQUEST","message":"end_date must be later than start_date","request_id":"example-request","details":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"5710726e-84da-458b-9d67-25fe8d6c2efc":{"description":"Missing, invalid or expired key, or invalid linked identity.","headers":{"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"},"WWW-Authenticate":{"schema":{"type":"string"},"example":"Bearer"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_CURSOR","SCHEDULE_TOO_LARGE","INVALID_SCHEDULE_EVENT","SCHEDULE_CONFLICT","STALE_REVISION","IDEMPOTENCY_CONFLICT","UNAUTHENTICATED","NOT_FOUND","METHOD_NOT_ALLOWED","RATE_LIMITED","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message","request_id","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"UNAUTHENTICATED","message":"A valid API key is required","request_id":"example-request","details":[]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"UNAUTHENTICATED","message":"A valid API key is required","request_id":"example-request","details":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"3284dfbe-aefb-45d5-9b7c-6b273d99cff5":{"description":"Missing resource or resource outside the authenticated company. Same response for both.","headers":{"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_CURSOR","SCHEDULE_TOO_LARGE","INVALID_SCHEDULE_EVENT","SCHEDULE_CONFLICT","STALE_REVISION","IDEMPOTENCY_CONFLICT","UNAUTHENTICATED","NOT_FOUND","METHOD_NOT_ALLOWED","RATE_LIMITED","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message","request_id","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"NOT_FOUND","message":"Resource not found","request_id":"example-request","details":[]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"NOT_FOUND","message":"Resource not found","request_id":"example-request","details":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"6d44d834-9332-4f0a-ac64-59902465c739":{"description":"Unsupported methods return 405. See the operation list for supported scheduling writes.","headers":{"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"},"Allow":{"schema":{"type":"string"},"example":"GET, HEAD, OPTIONS"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_CURSOR","SCHEDULE_TOO_LARGE","INVALID_SCHEDULE_EVENT","SCHEDULE_CONFLICT","STALE_REVISION","IDEMPOTENCY_CONFLICT","UNAUTHENTICATED","NOT_FOUND","METHOD_NOT_ALLOWED","RATE_LIMITED","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message","request_id","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"METHOD_NOT_ALLOWED","message":"This resource supports GET","request_id":"example-request","details":[]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"METHOD_NOT_ALLOWED","message":"This resource supports GET","request_id":"example-request","details":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"d45c5355-3f86-43df-b943-7025a6c487f1":{"description":"Stale revision, idempotency-key reuse with different input, scheduling conflict, or unsupported stored recurrence. Inspect error.code.","headers":{"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_CURSOR","SCHEDULE_TOO_LARGE","INVALID_SCHEDULE_EVENT","SCHEDULE_CONFLICT","STALE_REVISION","IDEMPOTENCY_CONFLICT","UNAUTHENTICATED","NOT_FOUND","METHOD_NOT_ALLOWED","RATE_LIMITED","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message","request_id","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"STALE_REVISION","message":"The visit changed; read it again before editing","request_id":"example-request","details":[]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"STALE_REVISION","message":"The visit changed; read it again before editing","request_id":"example-request","details":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"97abfc73-318a-431c-aec0-8d0052c13f7b":{"description":"Request body is too large.","headers":{"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_CURSOR","SCHEDULE_TOO_LARGE","INVALID_SCHEDULE_EVENT","SCHEDULE_CONFLICT","STALE_REVISION","IDEMPOTENCY_CONFLICT","UNAUTHENTICATED","NOT_FOUND","METHOD_NOT_ALLOWED","RATE_LIMITED","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message","request_id","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"INVALID_REQUEST","message":"Request body exceeds 64 KB","request_id":"example-request","details":[]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INVALID_REQUEST","message":"Request body exceeds 64 KB","request_id":"example-request","details":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"67b04a21-1b8f-4788-a9dd-820bcb3eca3a":{"description":"Company request budget exhausted; retry after the indicated delay.","headers":{"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"},"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds before retrying.","example":30}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_CURSOR","SCHEDULE_TOO_LARGE","INVALID_SCHEDULE_EVENT","SCHEDULE_CONFLICT","STALE_REVISION","IDEMPOTENCY_CONFLICT","UNAUTHENTICATED","NOT_FOUND","METHOD_NOT_ALLOWED","RATE_LIMITED","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message","request_id","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"RATE_LIMITED","message":"Request limit exceeded","request_id":"example-request","details":[]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"RATE_LIMITED","message":"Request limit exceeded","request_id":"example-request","details":[]}}}},"exampleType":"examples"}},"exampleType":"examples"},"d6aa6226-274b-4fde-a6c4-64074226c379":{"description":"Unexpected failure. Share request_id with support; no stack or provider secrets in response.","headers":{"Cache-Control":{"schema":{"type":"string"},"example":"private, no-store"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["INVALID_REQUEST","INVALID_CURSOR","SCHEDULE_TOO_LARGE","INVALID_SCHEDULE_EVENT","SCHEDULE_CONFLICT","STALE_REVISION","IDEMPOTENCY_CONFLICT","UNAUTHENTICATED","NOT_FOUND","METHOD_NOT_ALLOWED","RATE_LIMITED","INTERNAL_ERROR"],"isRequired":true,"uniqueKey":"error.code","typeLabel":"enum\u003cstring>"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"request_id":{"type":"string","isRequired":true,"uniqueKey":"error.request_id","typeLabel":"string"},"details":{"type":"array","items":{"type":"object","properties":{"field":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].field","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.details.items.[INDEX].message","typeLabel":"string"}},"required":["field","message"],"uniqueKey":"error.details.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object[]"}},"required":["code","message","request_id","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"INTERNAL_ERROR","message":"Unable to complete request","request_id":"example-request","details":[]}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"INTERNAL_ERROR","message":"Unable to complete request","request_id":"example-request","details":[]}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"91213982-be4d-405f-a0c8-b0a290a8cd6c":{"apiKey":{"type":"http","scheme":"bearer","description":"Existing Breezy API key. Grants all published reads and scheduling writes in its associated company. No app permission scopes.","scopes":[]}}},"servers":{"d4239c0d-e8dd-49f6-b7f4-2b5a3ad6583c":{"url":"https://api.getbreezyapp.com/v1","description":"Breezy FSM production API"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"Existing Breezy API key. Grants all published reads and scheduling writes in its associated company. No app permission scopes.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Existing Breezy API key. Grants all published reads and scheduling writes in its associated company. No app permission scopes.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"apiKey","name":"Authorization"}],"title":"apiKey"}]},"originalFileLocation":"openapi.json"},"subdomain":"breezy-fsm","siteName":"Breezy FSM API","title":"Breezy FSM API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-24T17:30:52.634Z","originalFileLocation":"api-reference/equipment/read-one-equipment.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Installed items at owned locations, with recorded condition, lifecycle dates, warranty terms, and optional same-location HVAC grouping. All operational statuses are included by default. No inferred age, warranty eligibility, or item service history.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Breezy FSM API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/breezy-fsm/dnF4NhhH8j4iUnof/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/breezy-fsm/dnF4NhhH8j4iUnof/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/breezy-fsm/dnF4NhhH8j4iUnof/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/breezy-fsm/dnF4NhhH8j4iUnof/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/breezy-fsm/dnF4NhhH8j4iUnof/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/breezy-fsm/dnF4NhhH8j4iUnof/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/breezy-fsm/dnF4NhhH8j4iUnof/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/breezy-fsm/dnF4NhhH8j4iUnof/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/breezy-fsm/dnF4NhhH8j4iUnof/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Breezy FSM API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Scheduling and operational and financial reporting: resources, pagination, business measures, and examples.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Breezy FSM API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.getbreezyapp.com/api-reference/equipment/read-one-equipment\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://breezy-fsm.mintlify.app/_mintlify/api/og/v2?division=Equipment\u0026amp;title=Read+one+equipment\u0026amp;description=Installed+items+at+owned+locations%2C+with+recorded+condition%2C+lifecycle+dates%2C+warranty+terms%2C+and+optional+same-location+HVAC+grouping.+All+operational+statuses\u0026amp;theme=eaf35dcff08c044ed1225cc1\u0026amp;signature=80b482984743995f5e28c5b71d1a5d76d271e20ab3e59dd99d35a9c3cad12a8a\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Breezy FSM API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Scheduling and operational and financial reporting: resources, pagination, business measures, and examples.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://breezy-fsm.mintlify.app/_mintlify/api/og/v2?division=Equipment\u0026amp;title=Read+one+equipment\u0026amp;description=Installed+items+at+owned+locations%2C+with+recorded+condition%2C+lifecycle+dates%2C+warranty+terms%2C+and+optional+same-location+HVAC+grouping.+All+operational+statuses\u0026amp;theme=eaf35dcff08c044ed1225cc1\u0026amp;signature=80b482984743995f5e28c5b71d1a5d76d271e20ab3e59dd99d35a9c3cad12a8a\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/breezy-fsm/dnF4NhhH8j4iUnof/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Breezy FSM API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0958D9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.getbreezyapp.com/api-reference/equipment/read-one-equipment\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/equipment/read-one-equipment.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.getbreezyapp.com/#organization\",\"name\":\"Breezy FSM API\",\"url\":\"https://developers.getbreezyapp.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/breezy-fsm/oiZqxfHjJWgR4SxV/logo/breezy-light.svg?fit=max\u0026auto=format\u0026n=oiZqxfHjJWgR4SxV\u0026q=85\u0026s=0d4ab09c4ec7a4400a349d0f2977aab8\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.getbreezyapp.com#website\",\"name\":\"Breezy FSM API\",\"url\":\"https://developers.getbreezyapp.com\",\"publisher\":{\"@id\":\"https://developers.getbreezyapp.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.getbreezyapp.com/api-reference/equipment/read-one-equipment#webpage\",\"url\":\"https://developers.getbreezyapp.com/api-reference/equipment/read-one-equipment\",\"name\":\"Read one equipment\",\"description\":\"Installed items at owned locations, with recorded condition, lifecycle dates, warranty terms, and optional same-location HVAC grouping. All operational statuses are included by default. No inferred age, warranty eligibility, or item service history.\",\"dateModified\":\"2026-09-24T17:30:52.634Z\",\"isPartOf\":{\"@id\":\"https://developers.getbreezyapp.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.getbreezyapp.com/api-reference/equipment/read-one-equipment#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.getbreezyapp.com/api-reference/equipment/read-one-equipment#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Equipment\",\"item\":\"https://developers.getbreezyapp.com/api-reference/equipment/page-equipment\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Read one equipment\",\"item\":\"https://developers.getbreezyapp.com/api-reference/equipment/read-one-equipment\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.getbreezyapp.com/api-reference/equipment/read-one-equipment#apireference\",\"headline\":\"Read one equipment\",\"name\":\"Read one equipment\",\"description\":\"Installed items at owned locations, with recorded condition, lifecycle dates, warranty terms, and optional same-location HVAC grouping. All operational statuses are included by default. No inferred age, warranty eligibility, or item service history.\",\"url\":\"https://developers.getbreezyapp.com/api-reference/equipment/read-one-equipment\",\"mainEntityOfPage\":{\"@id\":\"https://developers.getbreezyapp.com/api-reference/equipment/read-one-equipment#webpage\"},\"dateModified\":\"2026-09-24T17:30:52.634Z\",\"publisher\":{\"@id\":\"https://developers.getbreezyapp.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.getbreezyapp.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Breezy FSM API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Breezy FSM API","nav":{"global":null,"tabs":[{"tab":"Start here","pages":[{"title":"Start here","href":"/quickstart"}]},{"tab":"Reporting guides","pages":[{"title":"Reporting guides","href":"/choose-your-data"}]},{"tab":"API reference","groups":[{"group":"Scheduling","pages":[{"title":"Read a complete operational schedule","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule","href":"/api-reference/scheduling/read-a-complete-operational-schedule"},{"title":"Read members, arrival windows and calendar display bounds","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule/settings","href":"/api-reference/scheduling/read-members-arrival-windows-and-calendar-display-bounds"},{"title":"Read one visit with all assignments and its write revision","deprecated":null,"version":null,"openapi":"/openapi.json get /schedule/appointments/{id}","href":"/api-reference/scheduling/read-one-visit-with-all-assignments-and-its-write-revision"},{"title":"Create a visit for an existing job","deprecated":null,"version":null,"openapi":"/openapi.json post /job-appointments","href":"/api-reference/scheduling/create-a-visit-for-an-existing-job"},{"title":"Edit or reschedule a visit and its assignments atomically","deprecated":null,"version":null,"openapi":"/openapi.json patch /job-appointments/{id}","href":"/api-reference/scheduling/edit-or-reschedule-a-visit-and-its-assignments-atomically"},{"title":"Add one technician to a visit","deprecated":null,"version":null,"openapi":"/openapi.json post /job-assignments","href":"/api-reference/scheduling/add-one-technician-to-a-visit"},{"title":"Remove one assignment while retaining the visit","deprecated":null,"version":null,"openapi":"/openapi.json delete /job-assignments/{id}","href":"/api-reference/scheduling/remove-one-assignment-while-retaining-the-visit"},{"title":"Move or reassign one technician without replacing the visit","deprecated":null,"version":null,"openapi":"/openapi.json patch /job-assignments/{id}","href":"/api-reference/scheduling/move-or-reassign-one-technician-without-replacing-the-visit"},{"title":"Cancel a visit and remove its assignments","deprecated":null,"version":null,"openapi":"/openapi.json post /job-appointments/{id}/cancel","href":"/api-reference/scheduling/cancel-a-visit-and-remove-its-assignments"}]},{"group":"Company","pages":[{"title":"Read the company associated with this key","deprecated":null,"version":null,"openapi":"/openapi.json get /company","href":"/api-reference/company/read-the-company-associated-with-this-key"}]},{"group":"Invoices","pages":[{"title":"Page complete invoices","deprecated":null,"version":null,"openapi":"/openapi.json get /invoices","href":"/api-reference/invoices/page-complete-invoices"},{"title":"Read one complete invoice","deprecated":null,"version":null,"openapi":"/openapi.json get /invoices/{invoice_id}","href":"/api-reference/invoices/read-one-complete-invoice"}]},{"group":"Payments","pages":[{"title":"Page payments with their invoice allocations","deprecated":null,"version":null,"openapi":"/openapi.json get /payments","href":"/api-reference/payments/page-payments-with-their-invoice-allocations"},{"title":"Read one payment","deprecated":null,"version":null,"openapi":"/openapi.json get /payments/{payment_id}","href":"/api-reference/payments/read-one-payment"}]},{"group":"Refunds","pages":[{"title":"Page refunds using their own occurrence dates","deprecated":null,"version":null,"openapi":"/openapi.json get /refunds","href":"/api-reference/refunds/page-refunds-using-their-own-occurrence-dates"},{"title":"Read one refund","deprecated":null,"version":null,"openapi":"/openapi.json get /refunds/{refund_id}","href":"/api-reference/refunds/read-one-refund"}]},{"group":"Reports","pages":[{"title":"Summarize invoice activity by issue date","deprecated":null,"version":null,"openapi":"/openapi.json get /reports/invoice-activity","href":"/api-reference/reports/summarize-invoice-activity-by-issue-date"},{"title":"Summarize successful payments and refunds","deprecated":null,"version":null,"openapi":"/openapi.json get /reports/collections","href":"/api-reference/reports/summarize-successful-payments-and-refunds"},{"title":"Read current account aging","deprecated":null,"version":null,"openapi":"/openapi.json get /reports/receivables-aging","href":"/api-reference/reports/read-current-account-aging"},{"title":"Summarize recorded job profitability","deprecated":null,"version":null,"openapi":"/openapi.json get /reports/job-profitability","href":"/api-reference/reports/summarize-recorded-job-profitability"},{"title":"Summarize full-job profitability for assigned members","deprecated":null,"version":null,"openapi":"/openapi.json get /reports/technician-participation-profitability","href":"/api-reference/reports/summarize-full-job-profitability-for-assigned-members"},{"title":"Summarize recorded sold and earned credits by member","deprecated":null,"version":null,"openapi":"/openapi.json get /reports/revenue-attribution","href":"/api-reference/reports/summarize-recorded-sold-and-earned-credits-by-member"}]},{"group":"TeamMembers","pages":[{"title":"Page team members","deprecated":null,"version":null,"openapi":"/openapi.json get /team-members","href":"/api-reference/teammembers/page-team-members"},{"title":"Read one team member","deprecated":null,"version":null,"openapi":"/openapi.json get /team-members/{id}","href":"/api-reference/teammembers/read-one-team-member"}]},{"group":"Accounts","pages":[{"title":"Page accounts","deprecated":null,"version":null,"openapi":"/openapi.json get /accounts","href":"/api-reference/accounts/page-accounts"},{"title":"Read one account","deprecated":null,"version":null,"openapi":"/openapi.json get /accounts/{id}","href":"/api-reference/accounts/read-one-account"}]},{"group":"Contacts","pages":[{"title":"Page contacts","deprecated":null,"version":null,"openapi":"/openapi.json get /contacts","href":"/api-reference/contacts/page-contacts"},{"title":"Read one contact","deprecated":null,"version":null,"openapi":"/openapi.json get /contacts/{id}","href":"/api-reference/contacts/read-one-contact"}]},{"group":"Locations","pages":[{"title":"Page locations","deprecated":null,"version":null,"openapi":"/openapi.json get /locations","href":"/api-reference/locations/page-locations"},{"title":"Read one location","deprecated":null,"version":null,"openapi":"/openapi.json get /locations/{id}","href":"/api-reference/locations/read-one-location"}]},{"group":"Jobs","pages":[{"title":"Page jobs","deprecated":null,"version":null,"openapi":"/openapi.json get /jobs","href":"/api-reference/jobs/page-jobs"},{"title":"Read one job","deprecated":null,"version":null,"openapi":"/openapi.json get /jobs/{id}","href":"/api-reference/jobs/read-one-job"}]},{"group":"JobAppointments","pages":[{"title":"Page job appointments","deprecated":null,"version":null,"openapi":"/openapi.json get /job-appointments","href":"/api-reference/jobappointments/page-job-appointments"},{"title":"Read one job appointment","deprecated":null,"version":null,"openapi":"/openapi.json get /job-appointments/{id}","href":"/api-reference/jobappointments/read-one-job-appointment"}]},{"group":"JobAssignments","pages":[{"title":"Page job assignments","deprecated":null,"version":null,"openapi":"/openapi.json get /job-assignments","href":"/api-reference/jobassignments/page-job-assignments"},{"title":"Read one job assignment","deprecated":null,"version":null,"openapi":"/openapi.json get /job-assignments/{id}","href":"/api-reference/jobassignments/read-one-job-assignment"}]},{"group":"BusinessUnits","pages":[{"title":"Page business units","deprecated":null,"version":null,"openapi":"/openapi.json get /business-units","href":"/api-reference/businessunits/page-business-units"},{"title":"Read one business unit","deprecated":null,"version":null,"openapi":"/openapi.json get /business-units/{id}","href":"/api-reference/businessunits/read-one-business-unit"}]},{"group":"JobTypes","pages":[{"title":"Page job types","deprecated":null,"version":null,"openapi":"/openapi.json get /job-types","href":"/api-reference/jobtypes/page-job-types"},{"title":"Read one job type","deprecated":null,"version":null,"openapi":"/openapi.json get /job-types/{id}","href":"/api-reference/jobtypes/read-one-job-type"}]},{"group":"JobClasses","pages":[{"title":"Page job classes","deprecated":null,"version":null,"openapi":"/openapi.json get /job-classes","href":"/api-reference/jobclasses/page-job-classes"},{"title":"Read one job class","deprecated":null,"version":null,"openapi":"/openapi.json get /job-classes/{id}","href":"/api-reference/jobclasses/read-one-job-class"}]},{"group":"JobLifecycles","pages":[{"title":"Page job lifecycles","deprecated":null,"version":null,"openapi":"/openapi.json get /job-lifecycles","href":"/api-reference/joblifecycles/page-job-lifecycles"},{"title":"Read one job lifecycle","deprecated":null,"version":null,"openapi":"/openapi.json get /job-lifecycles/{id}","href":"/api-reference/joblifecycles/read-one-job-lifecycle"}]},{"group":"LeadSources","pages":[{"title":"Page lead sources","deprecated":null,"version":null,"openapi":"/openapi.json get /lead-sources","href":"/api-reference/leadsources/page-lead-sources"},{"title":"Read one lead source","deprecated":null,"version":null,"openapi":"/openapi.json get /lead-sources/{id}","href":"/api-reference/leadsources/read-one-lead-source"}]},{"group":"Tags","pages":[{"title":"Page tags","deprecated":null,"version":null,"openapi":"/openapi.json get /tags","href":"/api-reference/tags/page-tags"},{"title":"Read one tag","deprecated":null,"version":null,"openapi":"/openapi.json get /tags/{id}","href":"/api-reference/tags/read-one-tag"}]},{"group":"Estimates","pages":[{"title":"Page estimates","deprecated":null,"version":null,"openapi":"/openapi.json get /estimates","href":"/api-reference/estimates/page-estimates"},{"title":"Read one estimate","deprecated":null,"version":null,"openapi":"/openapi.json get /estimates/{id}","href":"/api-reference/estimates/read-one-estimate"}]},{"group":"JobLeads","pages":[{"title":"Page job leads","deprecated":null,"version":null,"openapi":"/openapi.json get /job-leads","href":"/api-reference/jobleads/page-job-leads"},{"title":"Read one job lead","deprecated":null,"version":null,"openapi":"/openapi.json get /job-leads/{id}","href":"/api-reference/jobleads/read-one-job-lead"}]},{"group":"Equipment","pages":[{"title":"Page equipment","description":"Installed items at owned locations, with recorded condition, lifecycle dates, warranty terms, and optional same-location HVAC grouping. All operational statuses are included by default. No inferred age, warranty eligibility, or item service history. Orders by id ascending. List and detail return the same complete representation. updated_since covers parent-row saves only.","deprecated":null,"version":null,"openapi":"/openapi.json get /equipment","href":"/api-reference/equipment/page-equipment"},{"title":"Read one equipment","deprecated":null,"version":null,"openapi":"/openapi.json get /equipment/{id}","href":"/api-reference/equipment/read-one-equipment"}]},{"group":"FormResponses","pages":[{"title":"Page form responses","description":"Captured visit forms with complete questions, recorded answers, original work relationships, and current required-data completeness. Current templates do not replace captured content. Unsupported capture returns null questions and completeness while retaining safe metadata. Orders by id ascending. List and detail return the same complete representation. updated_since covers parent-row saves only.","deprecated":null,"version":null,"openapi":"/openapi.json get /form-responses","href":"/api-reference/formresponses/page-form-responses"},{"title":"Read one form response","deprecated":null,"version":null,"openapi":"/openapi.json get /form-responses/{id}","href":"/api-reference/formresponses/read-one-form-response"}]},{"group":"TimeEntries","pages":[{"title":"Page recorded time entries","deprecated":null,"version":null,"openapi":"/openapi.json get /time-entries","href":"/api-reference/timeentries/page-recorded-time-entries"},{"title":"Read one time entry","deprecated":null,"version":null,"openapi":"/openapi.json get /time-entries/{id}","href":"/api-reference/timeentries/read-one-time-entry"}]},{"group":"Timesheets","pages":[{"title":"Page members in a configured timesheet period","deprecated":null,"version":null,"openapi":"/openapi.json get /timesheets","href":"/api-reference/timesheets/page-members-in-a-configured-timesheet-period"},{"title":"Read one member’s configured-period timesheet","deprecated":null,"version":null,"openapi":"/openapi.json get /timesheets/{team_member_id}","href":"/api-reference/timesheets/read-one-member’s-configured-period-timesheet"}]},{"group":"JobFinancials","pages":[{"title":"Page jobs with recorded costs and costing revenue","deprecated":null,"version":null,"openapi":"/openapi.json get /job-financials","href":"/api-reference/jobfinancials/page-jobs-with-recorded-costs-and-costing-revenue"},{"title":"Read the recorded financials of one job","deprecated":null,"version":null,"openapi":"/openapi.json get /job-financials/{id}","href":"/api-reference/jobfinancials/read-the-recorded-financials-of-one-job"}]},{"group":"RevenueAttributions","pages":[{"title":"Page jobs with complete saved sold and earned credits","deprecated":null,"version":null,"openapi":"/openapi.json get /revenue-attributions","href":"/api-reference/revenueattributions/page-jobs-with-complete-saved-sold-and-earned-credits"},{"title":"Read the complete saved revenue credits of one job","deprecated":null,"version":null,"openapi":"/openapi.json get /revenue-attributions/{id}","href":"/api-reference/revenueattributions/read-the-complete-saved-revenue-credits-of-one-job"}]}]}]},"title":"Breezy FSM API","buildId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","deploymentId":"dpl_849ArpqvBiCczQiT1Y1stNGpbqHT","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Bbp7I60D.js","utils-C3RIvJha.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DqD-vLt8.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B31Loprg.js","snippetPresets-DKpk-b8t.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-Cj65AhOR.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BXtn5gcC.js","shallow-RY2b03Cp.js","getApiPlaygroundDisplay-B0jeiPk3.js","CodeSnippet-CYgBjjwn.js","CodeSnippets-DOngDrYB.js","Page-n7I5XbKb.js","getPastedJson-DRQbJx-T.js","icon-CQiQCicY.js","MethodPill-BKTLdNtu.js","DuplicateIcon-B9jpAdat.js","createIcon-DCddRrXv.js","DynamicMarkdown-a8hUKrw6.js","SectionHeading-eECVV2eH.js","axios-vUo_bRtp.js","Markdown--GF7ZIpf.js","clsx-DZLdJUrt.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-2LoAhjKH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Zwc0ZncM.js"]}