---
title: "Get a client by identifier"
method: GET
path: "/clients/{identifier}"
tags: ["clients"]
---

# Get a client by identifier

`GET /clients/{identifier}`

Requires the privilege [`CLIENTS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Path parameters

- `identifier` string, required

## Query parameters

- `teamId` string, required

## Response `200`

- Client
  - `orgId` string
  - `identifier` string
  - `lastSeen` string, date-time
  - `lastSeenXff` string
  - `state` 'ACTIVE' | 'IDLE' | 'REVOKED' | 'INVITED'
  - `tags` object
  - `revokedBy` string
  - `authType` 'SECRET' | 'CERTIFICATE'
  - `containerHash` integer
  - `networkInterfaceDataHash` integer
  - `networkInterfaceData` NetworkInterfaceData
    - `interfaces` NetworkInterface[]
      - `name` string
      - `ip_addresses` IPAddress[], required
        - `ip` string
        - `protocolFamily` 'INET' | 'INET6' | 'UNIX'
      - `is_default` boolean
      - `is_physical` boolean
      - `is_virtual` boolean
  - `osName` string
  - `osVersion` string
  - `dockerVersion` string
  - `containerDriver` string
  - `containerRuntime` string
  - `containerRuntimeVersion` string
  - `containerRuntimeApiVersion` string
  - `containers` Container[]
    - `id` string, required
    - `name` string
    - `image` string
    - `labels` object
    - `dns_servers` string[]
    - `dnsServers` string[]
  - `kubernetesVersion` string
  - `metricsEnabled` boolean
  - `processCollectionEnabled` boolean
  - `collectDnsEnabled` boolean
  - `usedProxy` boolean
  - `hardwareInfo` HardwareInfo
    - `cpu_data` CpuInfo[]
      - `name` string
    - `memory_size` integer
    - `gpu_data` GpuInfo[]
      - `name` string
      - `driver` string
      - `memory_size` integer
  - `instanceStartTime` string
  - `offsetInMinutesAfterBucketStart` integer
  - `validationResults` ValidationAttack
    - `agentTimestamp` integer
    - `clientVersion` string
    - `results` ValidationAttackResult[]
      - `attackType` string
      - `status` 'SUCCESS' | 'ERROR'
      - `rawErrors` string[]
      - `targeting` 'CONTAINER' | 'HOST'
    - `clientStatus` 'HEALTHY' | 'IMPAIRED' | 'UNHEALTHY'
  - `targetType` 'Host' | 'Container' | 'Docker' | 'Kubernetes'
  - `lastActiveEmitted` string, date-time
  - `createdAt` string, date-time
  - `updatedAt` string, date-time
  - `companyId` string
  - `versionInfo` VersionInfo
    - `gremlind` SemanticVersion
      - `major` integer
      - `minor` integer
      - `patch` integer
    - `gremlin` SemanticVersion
      - `major` integer
      - `minor` integer
      - `patch` integer
  - `dnsServers` string[]
  - `proxyUrl` string
  - `warnings` Warning[]
    - `key` 'W000' | 'W001' | 'W002' | 'W003' | 'W004' | 'Unknown'
    - `link` string
    - `summary` string
  - `pushPodCidrTags` boolean
  - `pushZoneCidrTags` boolean
  - `osType` 'Linux' | 'Windows'

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: CLIENTS_READ

---

[API](https://skmtc.net/gremlin/apis/gremlin-api.md) · [All operations](https://skmtc.net/gremlin/apis/gremlin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gremlin/gremlin-api/versions/70fe938a0b35/schema)