> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Devices

Retrieve a list of all endpoints that are associated with an account or organization.

<Note>
  External Documentation

  To learn more, visit the [Control D documentation](https://docs.controld.com/reference/get_devices).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter           | Description                                                                                                                                                                                |
  | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | Device Type         | Select whether to retrieve user devices or router devices. Leave empty to retrieve all devices.                                                                                            |
  | Sub Organization ID | The ID of the child sub-organization whose administrator you want to impersonate when executing this action.<br /><br />**Note:** Applicable only if you have an **organization** account. |
</div>

## Example Output

```json theme={"dark"}
{
	"body": {
		"devices": [
			{
				"PK": "2bmen1byrpr",
				"ts": 1669593191,
				"name": "not-default-device",
				"stats": 2,
				"device_id": "2bmen1byrpr",
				"status": 1,
				"restricted": 0,
				"learn_ip": 1,
				"desc": "Comment goes here 2",
				"ddns": {
					"status": 1,
					"subdomain": "my-private-subdomain2",
					"hostname": "my-private-subdomain2.controld.xyz",
					"record": "2607:f0c8:8000:8210:1c7b:b482:1c88:e893"
				},
				"ddns_ext": {
					"status": 1,
					"host": "test.com"
				},
				"resolvers": {
					"uid": "2bmen1byrpr",
					"doh": "https://dns.controld.dev/2bmen1byrpr",
					"dot": "2bmen1byrpr.dns.controld.dev",
					"v4": [
						"176.125.239.187",
						"176.125.53.187"
					],
					"v6": [
						"2606:1a40:f000:1e:2c0e:761:3fcf:0",
						"2606:1a40:f001:1e:2c0e:761:3fcf:0"
					]
				},
				"legacy_ipv4": {
					"resolver": "176.125.239.187",
					"status": 1
				},
				"profile": {
					"PK": "4054dvb42i",
					"updated": 1670294164,
					"name": "Totally Not Default Profile"
				}
			},
			{
				"PK": "hl7r34ku0f",
				"ts": 1670036258,
				"name": "test-01",
				"device_id": "hl7r34ku0f",
				"status": 1,
				"icon": "desktop-windows",
				"learn_ip": 1,
				"resolvers": {
					"uid": "hl7r34ku0f",
					"doh": "https://dns.controld.dev/hl7r34ku0f",
					"dot": "hl7r34ku0f.dns.controld.dev"
				},
				"profile": {
					"PK": "4054dvb42i",
					"updated": 1670294164,
					"name": "Totally Not Default Profile"
				}
			}
		],
		"activity": false
	},
	"success": true
}
```

## Workflow Library Example

[List Devices with Control D and Send Results Via Email](https://library.blinkops.com/workflows/list-devices-with-control-d-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-devices-with-control-d-and-send-results-via-email/canvas" />
</div>