{"openapi":"3.1.0","info":{"title":"Takzor — rental maintenance for AI agents","version":"1.1.0","description":"Find, evaluate, book, track, verify and pay for rental property maintenance in central Oklahoma. No account or key. Read https://takzor.com/llms.txt first."},"servers":[{"url":"https://takzor.com"}],"paths":{"/api/v1/info":{"get":{"operationId":"takzorInfo","summary":"The rate board, coverage, commitments and facts","responses":{"200":{"description":"Everything Takzor publishes, as data","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/coverage":{"get":{"operationId":"checkCoverage","summary":"Is this ZIP (or address) in Takzor’s area?","parameters":[{"name":"zip","in":"query","schema":{"type":"string"}},{"name":"address","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"{covered: true | false | null}","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/service-requests":{"post":{"operationId":"requestService","summary":"Book a repair for a landlord","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["landlord","property","issue"],"properties":{"landlord":{"type":"object","required":["name"],"description":"The landlord or manager the work is for. Phone or email is required.","properties":{"name":{"type":"string"},"company":{"type":"string"},"phone":{"type":"string","description":"US mobile, 10 digits"},"email":{"type":"string","format":"email"},"type":{"type":"string","enum":["landlord","property manager","realtor"],"default":"landlord"}}},"property":{"type":"object","required":["address"],"properties":{"address":{"type":"string","description":"Street, city, state, ZIP — central Oklahoma"},"unit":{"type":"string"},"occupancy":{"type":"string","enum":["occupied","vacant"]}}},"service":{"type":"string","enum":["service_call","turn","repair","paint","flooring","other"],"default":"service_call"},"issue":{"type":"string","maxLength":140,"description":"What needs fixing, in a few words"},"details":{"type":"string","maxLength":1500},"resident":{"type":"object","properties":{"name":{"type":"string"},"phone":{"type":"string"}},"description":"Who to schedule with (occupied homes)"},"entry":{"type":"string","description":"Permission to enter, pets, lockbox or key notes"},"urgency":{"type":"string","enum":["normal","urgent","emergency"],"default":"normal"},"not_to_exceed":{"type":"number","description":"The landlord’s spending limit in US dollars; we check with them before going over it"},"your_reference":{"type":"string","description":"The landlord’s own work order or ticket number (the same one again is the same request)"},"sms_ok":{"type":"boolean","default":false,"description":"True only if the landlord agreed to receive texts from Takzor about this job"},"callback_url":{"type":"string","format":"uri","description":"https URL; Takzor POSTs the status JSON there each time the request changes"},"photos":{"type":"array","maxItems":6,"items":{"type":"object","properties":{"content_type":{"type":"string","enum":["image/jpeg","image/png","image/webp","image/heic"]},"data_base64":{"type":"string"}}}}}}}}},"responses":{"200":{"description":"The same reference again — the existing request","content":{"application/json":{"schema":{"type":"object"}}}},"201":{"description":"{request_id, status_token, status_url, report_url}","content":{"application/json":{"schema":{"type":"object"}}}},"400":{"description":"Something required is missing","content":{"application/json":{"schema":{"type":"object"}}}},"422":{"description":"Outside the service area","content":{"application/json":{"schema":{"type":"object"}}}},"429":{"description":"Too many requests","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/service-requests/{status_token}":{"get":{"operationId":"requestStatus","summary":"Where it stands","parameters":[{"name":"status_token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Status","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/service-requests/{status_token}/report":{"get":{"operationId":"fieldReport","summary":"The field report as data, reconciled with the invoice","parameters":[{"name":"status_token","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Report","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Unknown","content":{"application/json":{"schema":{"type":"object"}}}},"409":{"description":"Not finished yet","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}