Airthings Thresholds API

The Thresholds API from Airthings — 1 operation(s) for thresholds.

Operations 1

GET //v1/thresholds Device thresholds #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/airthings:airthings-thresholds-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

airthings-thresholds-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Airthings Thresholds API
  version: v1
  contact:
    name: Airthings Support
    email: support@airthings.com
servers:
- url: https://ext-api.airthings.com
security:
- AirthingsAccounts: []
tags:
- name: Thresholds
paths:
  //v1/thresholds:
    parameters:
    - name: measurementSystem
      in: query
      schema:
        type: string
        enum:
        - US
        - METRIC
        description: Measurement unit preference. Defaults to `METRIC`
      required: false
      deprecated: false
    - name: radonUnit
      in: query
      schema:
        type: string
        enum:
        - pci
        - bq
      required: false
      deprecated: false
    - name: tempUnit
      in: query
      schema:
        type: string
        enum:
        - c
        - f
      required: false
      deprecated: false
    - name: pressureUnit
      in: query
      schema:
        type: string
        enum:
        - hpa
        - inhg
      required: false
      deprecated: false
    - name: vocUnit
      in: query
      schema:
        type: string
        enum:
        - ppb
        - mgpc
      required: false
      deprecated: false
    get:
      tags:
      - Thresholds
      summary: Device thresholds
      description: Get threshold values for a device's sensors
      parameters: []
      responses:
        '200':
          description: Sensor thresholds
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SensorsThresholdResponse'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      deprecated: false
      security: []
      operationId: getV1Thresholds
      x-operation-id-source: derived
components:
  schemas:
    ThresholdRange:
      type: object
      properties:
        from:
          oneOf:
          - type: 'null'
          - type: number
            format: int32
        rating:
          $ref: '#/components/schemas/SensorRangeRating'
        to:
          oneOf:
          - type: 'null'
          - type: number
            format: int32
      required:
      - rating
    SensorThreshold:
      type: object
      properties:
        ranges:
          items:
            $ref: '#/components/schemas/ThresholdRange'
          type: array
        type:
          $ref: '#/components/schemas/SensorType'
        unit:
          $ref: '#/components/schemas/SensorUnit'
      required:
      - ranges
      - type
      - unit
    SensorsThresholdResponse:
      type: object
      properties:
        thresholds:
          additionalProperties:
            $ref: '#/components/schemas/SensorThreshold'
          type: object
      required:
      - thresholds
    SensorRangeRating:
      type: string
      enum:
      - POOR
      - FAIR
      - GOOD
    Code:
      type: string
      enum:
      - invalid_request
      - invalid_request_clients_limit_exceeded
      - access_denied
      - valid_subscription_required
      - device_not_supported
      - invalid_parameter
      - not_found
      - internal_server_error
      - unable_to_register_device
      - location_not_found
      - no_access_to_resource
      - missing_location_properties_for_report
      - radio_region_is_not_supported
      - max_number_of_devices_reached
      - unable_to_create_location
      - unable_to_update_space
    ErrorResponse:
      type: object
      properties:
        error:
          $ref: '#/components/schemas/Code'
        error_code:
          oneOf:
          - type: 'null'
          - type: number
            format: int32
        error_description:
          type: string
      required:
      - error
      - error_description
    SensorUnit:
      type: string
      enum:
      - COUNT
      - CELSIUS
      - FAHRENHEIT
      - MILLIBAR
      - PASCAL
      - HECTOPASCAL
      - INCHES_OF_MERCURY
      - BECQUEREL
      - PICOCURIE
      - PERCENT
      - VOLT
      - MILLIVOLT
      - PARTS_PER_MILLION
      - PARTS_PER_BILLION
      - ANGLE
      - MICRO_GRAM_PER_CUBIC
      - METERS
      - KILOMETERS
      - KILOMETERS_PER_HOUR
      - KILOWATTS
      - MILES_PER_HOUR
      - RISK_INDEX
      - SOUND_PRESSURE
      - WEATHER_CODE
      - CUBIC_METER_PER_HOUR
      - CONFIDENCE
      - VENTILATION_STATE
      - SECONDS
      - MINUTES
      - INFO
      - MILLIMETERS
      - DECIBEL_MILLIWATTS
      - OCCUPANTS
      - AIR_CHANGES_PER_HOUR
      - LUX
      - CUBIC_FEET_PER_MINUTE
      - FEET
    SensorType:
      type: string
      enum:
      - radonShortTermAvg
      - radonLongTermAvg
      - hctsbk
      - hctsrn222l
      - hctsrn222h
      - hctssa
      - hctspo21xl
      - hctspo21xh
      - hctscomparator
      - hctsprocessed
      - temp
      - outdoorTemp
      - humidity
      - outdoorHumidity
      - co2
      - voc
      - pressure
      - outdoorPressure
      - pressureDifference
      - light
      - lux
      - batteryPercentage
      - batteryVoltage
      - orientation
      - pm1
      - pm25
      - pm10
      - mold
      - staleAir
      - transmissionEfficiency
      - virusSurvivalRate
      - virusRisk
      - windSpeed
      - windDirection
      - windGust
      - dewPoint
      - cloudCover
      - visibility
      - precipitation_probability
      - total_precipitation
      - outdoorWeather
      - hourlyRadonStandardDeviation
      - hourlyRadon
      - historicVentilationConfidence
      - daytimeBaseline
      - daytimePeak
      - nightBaseline
      - historicVentilation
      - ventilationRunningConfidence
      - occupantsUpper
      - occupantsLower
      - presence
      - occupants
      - relativeOccupants
      - ventilationAmount
      - historicVentilationRunning
      - ventilationRunning
      - ventilationAmountRelative
      - airExchangeRateUpper
      - airExchangeRateLower
      - airExchangeRate
      - sla
      - bacnet
  securitySchemes:
    AirthingsAccounts:
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.airthings.com/authorize
          tokenUrl: https://accounts-api.airthings.com/v1/token
          scopes:
            read:device: Allowing a user to read data from devices in their account
            write:device: Allowing a user to manage devices within their account
        clientCredentials:
          tokenUrl: https://accounts-api.airthings.com/v1/token
          scopes:
            read:device: Allowing a user to read data from devices in their account
            write:device: Allowing a user to manage devices within their account
      type: oauth2
x-provenance:
  method: searched
  source: https://developer-business.airthings.com/reference
  harvested: '2026-10-28'
  tool: harvest-readme-openapi.py
  note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
  assembled_from:
  - https://developer-business.airthings.com/reference/deletev1webhookshookid.md
  - https://developer-business.airthings.com/reference/getv1accounts.md
  - https://developer-business.airthings.com/reference/getv1devices.md
  - https://developer-business.airthings.com/reference/getv1devicesserialnumber.md
  - https://developer-business.airthings.com/reference/getv1devicesserialnumberbattery.md
  - https://developer-business.airthings.com/reference/getv1devicesserialnumberhourlyradonsamples.md
  - https://developer-business.airthings.com/reference/getv1devicesserialnumberlatestbattery.md
  - https://developer-business.airthings.com/reference/getv1devicesserialnumberlatestsamples.md
  - https://developer-business.airthings.com/reference/getv1devicesserialnumbermoldsamples.md
  - https://developer-business.airthings.com/reference/getv1devicesserialnumberoccupancysamples.md
  - https://developer-business.airthings.com/reference/getv1devicesserialnumbersamples.md
  - https://developer-business.airthings.com/reference/getv1devicesserialnumberthresholdbreaches.md
  - https://developer-business.airthings.com/reference/getv1devicesserialnumberventilationsamples.md
  - https://developer-business.airthings.com/reference/getv1devicesserialnumbervirusrisksamples.md
  - https://developer-business.airthings.com/reference/getv1locations.md
  - https://developer-business.airthings.com/reference/getv1locationslocationid.md
  - https://developer-business.airthings.com/reference/getv1locationslocationidlatestsamples.md
  - https://developer-business.airthings.com/reference/getv1organizations.md
  - https://developer-business.airthings.com/reference/getv1segments.md
  - https://developer-business.airthings.com/reference/getv1segmentssegmentid.md
  - https://developer-business.airthings.com/reference/getv1segmentssegmentidhourlyradonsamples.md
  - https://developer-business.airthings.com/reference/getv1segmentssegmentidmoldsamples.md
  - https://developer-business.airthings.com/reference/getv1segmentssegmentidoccupancysamples.md
  - https://developer-business.airthings.com/reference/getv1segmentssegmentidsamples.md
  - https://developer-business.airthings.com/reference/getv1segmentssegmentidventilationsamples.md
  - https://developer-business.airthings.com/reference/getv1segmentssegmentidvirusrisksamples.md
  - https://developer-business.airthings.com/reference/getv1thresholds.md
  - https://developer-business.airthings.com/reference/getv1webhooks.md
  - https://developer-business.airthings.com/reference/patch_v1-spaces.md
  - https://developer-business.airthings.com/reference/patchv1devices.md
  - https://developer-business.airthings.com/reference/patchv1deviceslabels.md
  - https://developer-business.airthings.com/reference/patchv1webhookshookid.md
  - https://developer-business.airthings.com/reference/postv1locations.md
  - https://developer-business.airthings.com/reference/postv1locationslocationiddevices.md
  - https://developer-business.airthings.com/reference/postv1webhooks.md
  merge:
    pages: 35
    deduped: 161
    conflicts_kept_first: 0