---
title: "List Active Directory Agents"
method: GET
path: "/api/v2/activedirectories/{activedirectory_id}/agents"
tags: ["Active Directory"]
---

# List Active Directory Agents

`GET /api/v2/activedirectories/{activedirectory_id}/agents`

## Request

- Base URL: `https://console.jumpcloud.com`
- URL: `https://console.jumpcloud.com/api/v2/activedirectories/{activedirectory_id}/agents`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/docs/api/v2/activedirectories/:activedirectory_id/agents/get.ts> (a function with typed inputs; its response is checked against the schema)

This endpoint allows you to list all your Active Directory Agents for a given Instance.

#### Sample Request
```
curl -X GET https://console.jumpcloud.com/api/v2/activedirectories/{activedirectory_id}/agents \
  -H 'accept: application/json' \
  -H 'content-type: application/json' \
  -H 'x-api-key: {API_KEY}'
  ```

## Query parameters

- `limit` integer
- `skip` integer
- `sort` string[]

## Headers

- `x-org-id` string

## Response `200`

- ActiveDirectoryAgentList[]
  - `contactAt` string, nullable
  - `hostname` string, nullable
  - `hostType` string, nullable: Host role reported by the agent (DOMAIN_CONTROLLER or MEMBER_SERVER).
  - `id` string: ObjectID of this Active Directory Agent.
  - `passwordUpdatedAt` string, date-time, nullable
  - `source_ip` string, nullable
  - `state` 'unsealed' | 'active' | 'inactive'
  - `agentType` 'SYNC' | 'IMPORT'
  - `version` string, nullable
  - `idSourceId` string, nullable: ObjectID of this Active Directory Agent in IdSource table.

---

[API](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-console-api/revisions/f396d9271b46?raw)