{"ok":true,"service":"HSM-Siivouspalvelu quote-request API (tarjouspyynnöt, ylläpitosiivous)","provider":"HSM-Toimialapalvelu Oy — home cleaning in Vaasa, Laihia, Ilmajoki and Seinäjoki (Finland)","how_to_submit":"POST application/json to this same URL (https://hsm-siivouspalvelu.fi/api/lead). No API key needed.","required_fields":{"name":"string, max 200 — the customer's real name","email":"string, max 254, valid email — the customer's real address","frequency":"weekly | biweekly | monthly | once — required for quote requests; NOT required when form_type is 'contact'"},"optional_fields":{"form_type":"'contact' for a plain contact/tarjouspyyntö WITHOUT the calculator estimate (no frequency needed, no draft quote created — a human replies). Omit for a normal quote request.","rooms":"integer 1-15 (default 3) — kitchen, living room and bedrooms; do not count bathrooms","vat_free":"JSON boolean, true ONLY if the customer qualifies for VAT-0% social service (reduced functional capacity due to old age, illness or disability)","phone":"string, max 50","address":"string, max 200","postal_code":"string, max 10","city":"string, max 100","message":"string, max 2000 — pets, key handover, special wishes","agent":"string, max 200 — AI-assistant self-identification, e.g. 'Claude (Anthropic)'. Please set this whenever an assistant submits on a customer's behalf; the submission is then marked for the staff.","external_id":"format hsm-hintalaskuri-<uuid v4> — generate ONCE per customer intent and reuse on retries","page_url":"https:// URL, max 300","utm_source | utm_medium | utm_campaign | utm_content | utm_term":"string, max 200"},"rules":["Submit only with the customer's informed consent, and only the customer's real contact details.","Never fabricate or guess data; omit optional fields you do not know.","One submission per customer intent. On network errors or 5xx, retry with the SAME external_id; a response {\"ok\":true,\"duplicate\":true} means the earlier attempt already succeeded.","No test submissions: every accepted POST creates a real sales lead handled by a human.","Scope: recurring or one-time home cleaning (ylläpitosiivous) only. For office cleaning, window washing or move-out cleaning, have the customer call +358 50 413 1081 or email asiakaspalvelu@hsm-toimialapalvelu.fi."],"responses":{"200":"{\"ok\":true} or {\"ok\":true,\"duplicate\":true} (duplicate = the same external_id already succeeded; treat as success)","400":"{\"ok\":false,\"error\":{...},\"fields\":{...}} — field messages are in Finnish","413":"request body over 10 KB","502":"temporary upstream failure — retry later with the SAME external_id"},"pricing_reference":"https://hsm-siivouspalvelu.fi/llms.txt — the server recomputes the price estimate authoritatively from rooms + frequency + vat_free","docs":{"openapi":"https://hsm-siivouspalvelu.fi/api/openapi.json","agents_manifest":"https://hsm-siivouspalvelu.fi/agents.json","llms_txt":"https://hsm-siivouspalvelu.fi/llms.txt","human_form":"https://hsm-siivouspalvelu.fi/hintalaskuri.html","privacy":"https://hsm-siivouspalvelu.fi/tietosuoja.html"}}