---
title: "List DTT devices"
method: GET
path: "/dtt"
tags: ["DTT"]
---

# List DTT devices

`GET /dtt`

## Request

- Base URL: `https://dashboard.researchanddesire.com/api/v1`
- URL: `https://dashboard.researchanddesire.com/api/v1/dtt`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `/oauth/authorize`
    - Token URL: `/oauth/token` scopes: `dtt:read`

Returns all Deepthroat Trainer devices registered to your account, ordered by most recently visited.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

List of DTT devices

- DttDeviceListResponse
  - `ok` true, required
  - `data` object, required
    - `data` DttDevice[], required
      - `id` integer: Device ID
      - `bubbleId` string: Unique public identifier
      - `ownerId` integer: Owner user ID
      - `macAddress` string: Device MAC address
      - `serialNumber` string: Device serial number
      - `softwareVersion` string: Current firmware version
      - `lastVisited` string, date-time: Last connection time
      - `lastLogAt` string, date-time: Last log entry time
      - `createdDate` string, date-time: Device registration date
      - `apiHits` integer: API call count
    - `pagination` Pagination, required
      - `limit` integer, required: Number of records returned
      - `offset` integer, required: Number of records skipped

## Other responses

- `401`: Authentication required or token invalid
- `500`: Internal server error

## Changes

- **2026-09-22** `2411203b3c10`: 2 info
  - the endpoint scheme security `bearerAuth` was added to the API
  - the endpoint scheme security `oauth2` was added to the API

[Operation history](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/changes/dtt/get.md)

---

[API](https://skmtc.dev/researchanddesire/apis/research-and-desire-api.md) - [All operations](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/llms.txt) - [OpenAPI document](https://skmtc.dev/researchanddesire/apis/research-and-desire-api/revisions/682fc4d7f6d5?raw)