# Retrieve the list of instruments

Get a list of all instruments that can be accessed with your account or api key.

Requires an API key with the instruments:read scope.

Endpoint: GET /control/instruments
Version: 1.0.1
Security: apikey

## Response 200 fields (application/json):

  - `type` (string)
    Type of instrument
    Enum: "Noise", "AirQuality", "Vibration"

  - `serialNumber` (string)
    Serial number of the instrument

  - `model` (string)
    Model of the instrument

  - `name` (string)
    Friendly name or description of the instrument

  - `image` (string)
    URL of the image for the instrument

  - `subscription` (object)
    Subscription details for this instrument

  - `subscription.status` (string)
    Status of the subscription
    Enum: "Active", "Cancelled", "Expired"

  - `subscription.tier` (string)
    Tier of the subscription
    Enum: "Standard", "Pro", "Storage", "Track", "Enviro"

  - `subscription.addons` (array)
    Addons for the subscription
    Enum: "Audio"

  - `position` (object)
    Position of the instrument

  - `position.latitude` (number)

  - `position.longitude` (number)

  - `feature` (array)
    Additional features available on this instrument
    Enum: "SIC", "Modem", "Weather"

## Response 401 fields (application/json):

  - `error` (string)
    Error code

  - `description` (string)
    Description of the error

## Response 403 fields (application/json):

  - `error` (string)
    Error code

  - `description` (string)
    Description of the error

## Response 429 fields (application/json):

  - `error` (string)
    Error code

  - `description` (string)
    Description of the error