---
title: "Get Active Directory Agent"
method: GET
path: "/activedirectories/{activedirectory_id}/agents/{agent_id}"
tags: ["Active Directory"]
---

# Get Active Directory Agent

`GET /activedirectories/{activedirectory_id}/agents/{agent_id}`

## Request

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

This endpoint returns an Active Directory agent.

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

## 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-api-2.md) - [All operations](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/jumpcloud/apis/jumpcloud-api-2/revisions/3f09fe63caaa?raw)