apitoolcalls-com Water Softener Size API

openapi: 3.2.0
info:
  title: Apitoolcalls Com Water Softener Size API
  version: 1.0.0
  contact:
    name: Cowerx
    url: https://apitoolcalls.com/api/
  description: 'Operations tagged Water Softener Size across 2 of this provider''s published API definitions: openapi.json, apitoolcalls-com-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://apitoolcalls.com
tags:
- name: Water Softener Size
paths:
  /api/water-softener-size:
    get:
      description: Size a water softener from household water use and tested hardness, with yearly salt cost. Gallons per person per day is required (no national default used), for softened water only. Iron is optional; unknown when absent, and changes the setting per EcoPure's clear-water ferrous iron rule (5 gpg per ppm); other makers differ. Returns grains per day, working capacity before reserve, optional paired model ratings, three idealized EP42 test-rating examples, notes, assumptions and dated primary sources. Costs are salt only. Pure Decimal arithmetic, no network or model.
      operationId: water_softener_size
      parameters:
      - in: query
        name: hardness
        required: true
        schema:
          description: Required measured hardness; after conversion 0 < gpg <= 100.
          exclusiveMinimum: 0
          type: number
      - in: query
        name: unit
        required: false
        schema:
          default: gpg
          description: gpg or mg/L; divide mg/L by 17.1 (W1).
          enum:
          - gpg
          - mg_l
          type: string
      - in: query
        name: people
        required: true
        schema:
          description: Required whole household size.
          maximum: 20
          minimum: 1
          type: integer
      - in: query
        name: gallons
        required: true
        schema:
          description: Required softened gallons per person per day; no national default used. Exclude bypassing outdoor taps.
          maximum: 300
          minimum: 10
          type: number
      - in: query
        name: iron
        required: false
        schema:
          description: Optional dissolved clear-water ferrous iron in ppm; absent means unknown. EcoPure adds 5 gpg per ppm (W4); other makers differ.
          maximum: 20
          minimum: 0
          type: number
      - in: query
        name: interval
        required: false
        schema:
          description: Optional target days between regenerations.
          maximum: 60
          minimum: 1
          type: number
      - in: query
        name: capacity
        required: false
        schema:
          description: Your manual's grains per regeneration; requires salt_lb.
          maximum: 200000
          minimum: 1000
          type: number
      - in: query
        name: salt
        required: false
        schema:
          description: Your manual's lb salt at capacity_grains; requires capacity_grains.
          maximum: 50
          minimum: 0.5
          type: number
      - in: query
        name: bag_price
        required: false
        schema:
          default: 8.97
          description: Price per bag; one store's price (Fleet Farm, observed 2 Oct 2026); enter yours.
          maximum: 200
          minimum: 0.01
          type: number
      - in: query
        name: bag_lb
        required: false
        schema:
          default: 40
          description: Bag weight in lb.
          maximum: 100
          minimum: 1
          type: number
      responses:
        '200':
          content:
            application/json:
              schema:
                additionalProperties: true
                properties:
                  link:
                    examples:
                    - https://apitoolcalls.com/water-softener-size/?utm_source=api&utm_medium=api
                    format: uri
                    type: string
                  via:
                    const: API Tool Calls
                    type: string
                required:
                - via
                - link
                type: object
          description: Successful tool result with attribution.
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                    required:
                    - message
                    type: object
                required:
                - error
                type: object
          description: Invalid tool arguments.
        '429':
          content:
            application/json:
              schema:
                properties:
                  error:
                    properties:
                      code:
                        type: integer
                      message:
                        type: string
                    required:
                    - message
                    type: object
                required:
                - error
                type: object
          description: Free call limit reached; try again after the limit resets.
      tags:
      - Water Softener Size
      summary: Water softener size
      x-summary-source: derived
    servers:
    - url: https://apitoolcalls.com
x-refined-from:
- openapi.json
- apitoolcalls-com-openapi.json