---
title: "Returns all integration clients within a company or team."
method: GET
path: "/integration-clients"
tags: ["integration-clients"]
---

# Returns all integration clients within a company or team.

`GET /integration-clients`

This operation will return all active, idle, and recently inactive integration clients.
Requires the privilege [`INTEGRATIONS_READ`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Query parameters

- `teamId` string, required

## Response `default`

default response

- IdentitiesPrivateNetworkClient
  - `active` PrivateNetworkClient[]
    - `companyId` string
    - `identifier` string
    - `lastSeen` string, date-time
    - `lastSeenXff` string
    - `orgId` string
    - `state` 'ACTIVE' | 'IDLE' | 'REVOKED' | 'INVITED'
    - `tags` object
    - `revokedBy` string
    - `authType` 'SECRET' | 'CERTIFICATE'
    - `osType` string
    - `osName` string
    - `osVersion` string
    - `usedProxy` boolean
    - `instanceStartTime` string
    - `lastActiveEmitted` string, date-time
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `active` boolean
    - `revoked` boolean
    - `idle` boolean
    - `gremlinClientVersion` string
  - `idle` PrivateNetworkClient[]
    - `companyId` string
    - `identifier` string
    - `lastSeen` string, date-time
    - `lastSeenXff` string
    - `orgId` string
    - `state` 'ACTIVE' | 'IDLE' | 'REVOKED' | 'INVITED'
    - `tags` object
    - `revokedBy` string
    - `authType` 'SECRET' | 'CERTIFICATE'
    - `osType` string
    - `osName` string
    - `osVersion` string
    - `usedProxy` boolean
    - `instanceStartTime` string
    - `lastActiveEmitted` string, date-time
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `active` boolean
    - `revoked` boolean
    - `idle` boolean
    - `gremlinClientVersion` string
  - `inactive` PrivateNetworkClient[]
    - `companyId` string
    - `identifier` string
    - `lastSeen` string, date-time
    - `lastSeenXff` string
    - `orgId` string
    - `state` 'ACTIVE' | 'IDLE' | 'REVOKED' | 'INVITED'
    - `tags` object
    - `revokedBy` string
    - `authType` 'SECRET' | 'CERTIFICATE'
    - `osType` string
    - `osName` string
    - `osVersion` string
    - `usedProxy` boolean
    - `instanceStartTime` string
    - `lastActiveEmitted` string, date-time
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `active` boolean
    - `revoked` boolean
    - `idle` boolean
    - `gremlinClientVersion` string

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: INTEGRATIONS_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/revisions/36ee938323f0/schema)