{"ok":true,"service":"ArvokasArki contact / yhteydenotto API (tukipalvelut & kotisiivous)","provider":"ArvokasArki (Ristilä Group Oy) — Valvira-approved social support services for the elderly and families in the Seinäjoki–Vaasa region, Finland. All services are VAT-free (Sosiaalipalvelulaki 37 §).","how_to_submit":"POST application/json to this same URL (https://arvokasarki.fi/api/lead). No API key needed. Creates a contact request (lead); a human calls the customer back. No prices, no automatic quote.","required_fields":{"name":"string, max 200 — the customer's real name","phone":"string, max 50 — the primary contact channel for this audience"},"optional_fields":{"email":"string, max 254, valid email — recommended but not required","services":"array of strings — service interest, any of: 'tukipalvelut' (daily support: shopping, outdoor activities, companionship, laundry, home help), 'kotisiivous' (home cleaning). Descriptive only; no pricing.","palveluseteli":"boolean — does the customer have a palveluseteli (service voucher)? true/false. Omit if not known. Also accepts the strings 'kyllä'/'ei'.","message":"string, max 2000 — describe the kind of help needed, situation, schedule","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 arvokasarki-yhteydenotto-<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 contact request handled by a human.","Scope: home support and cleaning in the Seinäjoki–Vaasa region. For anything outside it, have the customer call 0400 997 340 or email asiakaspalvelu@arvokasarki.fi."],"responses":{"200":"{\"ok\":true,\"portal_url\":\"https://app.diiliputki.fi/oma/<token>\"} — portal_url is the customer's self-service page (view status, message the team; may be absent). {\"ok\":true,\"duplicate\":true} = 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"},"docs":{"openapi":"https://arvokasarki.fi/api/openapi.json","agents_manifest":"https://arvokasarki.fi/agents.json","llms_txt":"https://arvokasarki.fi/llms.txt","human_form":"https://arvokasarki.fi/#yhteystiedot","privacy":"https://arvokasarki.fi/tietosuoja.html"}}