Air Change Rate Calculator API - IOTools.cloud

curl --request POST \
  --url https://api.iotools.cloud/v1/tool/air-change-rate-calculator \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "calculationMode": "fromAirflow",
  "unitSystem": "us",
  "roomLength": "12",
  "roomWidth": "10",
  "roomHeight": "8",
  "airflow": "150"
}
'

{
  "tool": "air-change-rate-calculator",
  "tool_version": "1.0.2",
  "outputs": {
    "results": [
      {
        "metric": "Room volume",
        "value": "960.00 ft³"
      },
      {
        "metric": "Airflow",
        "value": "150.00 CFM"
      },
      {
        "metric": "Air changes per hour (ACH)",
        "value": "9.38"
      }
    ],
    "guidelineTable": [
      {
        "room-type": "Bedroom / living room",
        "typical-ach": "2-4 ACH",
        "match": ""
      },
      {
        "room-type": "Home office / study",
        "typical-ach": "4-6 ACH",
        "match": ""
      },
      {
        "room-type": "Open-plan office",
        "typical-ach": "4-6 ACH",
        "match": ""
      },
      {
        "room-type": "Classroom",
        "typical-ach": "6-8 ACH",
        "match": ""
      },
      {
        "room-type": "Bathroom",
        "typical-ach": "8-15 ACH",
        "match": "◄ Typical range"
      },
      {
        "room-type": "Kitchen (with cooking exhaust)",
        "typical-ach": "15-20 ACH",
        "match": ""
      },
      {
        "room-type": "Restaurant / dining area",
        "typical-ach": "8-12 ACH",
        "match": "◄ Typical range"
      },
      {
        "room-type": "Retail store",
        "typical-ach": "6-10 ACH",
        "match": "◄ Typical range"
      },
      {
        "room-type": "Warehouse / storage",
        "typical-ach": "2-4 ACH",
        "match": ""
      },
      {
        "room-type": "Laboratory (general)",
        "typical-ach": "6-12 ACH",
        "match": "◄ Typical range"
      },
      {
        "room-type": "Hospital patient room",
        "typical-ach": "6-10 ACH",
        "match": "◄ Typical range"
      },
      {
        "room-type": "Operating room",
        "typical-ach": "20-25 ACH",
        "match": ""
      },
      {
        "room-type": "Server room / data center",
        "typical-ach": "10-15 ACH",
        "match": ""
      },
      {
        "room-type": "Parking garage",
        "typical-ach": "4-6 ACH",
        "match": ""
      }
    ],
    "summary": "9.38 ACH for a 960 ft³ room at 150.00 CFM"
  },
  "credits_used": 5,
  "credits_remaining": null
}

POST

/

v1

/

tool

/

air-change-rate-calculator

curl --request POST \
  --url https://api.iotools.cloud/v1/tool/air-change-rate-calculator \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "calculationMode": "fromAirflow",
  "unitSystem": "us",
  "roomLength": "12",
  "roomWidth": "10",
  "roomHeight": "8",
  "airflow": "150"
}
'

{
  "tool": "air-change-rate-calculator",
  "tool_version": "1.0.2",
  "outputs": {
    "results": [
      {
        "metric": "Room volume",
        "value": "960.00 ft³"
      },
      {
        "metric": "Airflow",
        "value": "150.00 CFM"
      },
      {
        "metric": "Air changes per hour (ACH)",
        "value": "9.38"
      }
    ],
    "guidelineTable": [
      {
        "room-type": "Bedroom / living room",
        "typical-ach": "2-4 ACH",
        "match": ""
      },
      {
        "room-type": "Home office / study",
        "typical-ach": "4-6 ACH",
        "match": ""
      },
      {
        "room-type": "Open-plan office",
        "typical-ach": "4-6 ACH",
        "match": ""
      },
      {
        "room-type": "Classroom",
        "typical-ach": "6-8 ACH",
        "match": ""
      },
      {
        "room-type": "Bathroom",
        "typical-ach": "8-15 ACH",
        "match": "◄ Typical range"
      },
      {
        "room-type": "Kitchen (with cooking exhaust)",
        "typical-ach": "15-20 ACH",
        "match": ""
      },
      {
        "room-type": "Restaurant / dining area",
        "typical-ach": "8-12 ACH",
        "match": "◄ Typical range"
      },
      {
        "room-type": "Retail store",
        "typical-ach": "6-10 ACH",
        "match": "◄ Typical range"
      },
      {
        "room-type": "Warehouse / storage",
        "typical-ach": "2-4 ACH",
        "match": ""
      },
      {
        "room-type": "Laboratory (general)",
        "typical-ach": "6-12 ACH",
        "match": "◄ Typical range"
      },
      {
        "room-type": "Hospital patient room",
        "typical-ach": "6-10 ACH",
        "match": "◄ Typical range"
      },
      {
        "room-type": "Operating room",
        "typical-ach": "20-25 ACH",
        "match": ""
      },
      {
        "room-type": "Server room / data center",
        "typical-ach": "10-15 ACH",
        "match": ""
      },
      {
        "room-type": "Parking garage",
        "typical-ach": "4-6 ACH",
        "match": ""
      }
    ],
    "summary": "9.38 ACH for a 960 ft³ room at 150.00 CFM"
  },
  "credits_used": 5,
  "credits_remaining": null
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

roomLength

number

required

Room length

Required range: x >= 0

roomWidth

number

required

Room width

Required range: x >= 0

roomHeight

number

required

Room height

Required range: x >= 0

calculationMode

enum<string>

Calculate

Available options:

fromAirflow,

fromTargetAch

unitSystem

enum<string>

Unit system

Available options:

si,

us

airflow

number

Airflow

Required range: x >= 0

targetAch

number

Target ACH

Required range: x >= 0

Response

Tool output

outputs

object

required

Show child attributes

tool

string

required

The tool's slug, echoing the {slug} in the request path.

tool_version

string

required

Output-contract version for this tool.

credits_used

integer

required

Credits this call consumed, after any settlement refund. 0 when metering is disabled.

credits_remaining

integer | null

required

Credits left in the current monthly allowance, or null when metering is disabled.

request_id

string

Correlation id, also sent as x-request-id.