Get a service account
GET
/v1/oauth/clients/{id}
const url = 'https://api.adversarial.com/api/v1/oauth/clients/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0';const options = {method: 'GET', headers: {cookie: 'arm-session=<arm-session>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://api.adversarial.com/api/v1/oauth/clients/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0 \ --cookie arm-session=<arm-session>Returns the service account’s name, assigned role, and revoked status. The client secret is never included, and the client ID, IP allowlist and expiry only for the account’s owner or an administrator.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”id
required
string format: uuid
OAuth client ID
Responses
Section titled “Responses”OAuth client details
Media typeapplication/json
object
allowed_ips
Array<string> | null
client_id
Omitted, along with allowed_ips and expires_at, unless the caller
owns the service account or is an administrator.
string | null
client_name
required
string
client_secret
string | null
created_by
string | null format: uuid
created_date
required
string format: date-time
expires_at
string | null format: date-time
id
required
string format: uuid
last_used
string | null format: date-time
org_id
required
string format: uuid
revoked_at
string | null format: date-time
roles
required
Array<string>
user
required
The service-account user this key authenticates as — one user per key.
object
email
required
string
first_name
required
string
icon
Relative path to the user’s avatar endpoint, e.g.
"users/{id}/avatar?v={hash}". None when the user has no avatar.
string | null
id
required
string format: uuid
last_name
required
string
user_id
required
string format: uuid
Examplegenerated
{ "allowed_ips": [ "example" ], "client_id": "example", "client_name": "example", "client_secret": "example", "created_by": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "created_date": "2026-04-15T12:00:00Z", "expires_at": "2026-04-15T12:00:00Z", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "last_used": "2026-04-15T12:00:00Z", "org_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "revoked_at": "2026-04-15T12:00:00Z", "roles": [ "example" ], "user": { "email": "example", "first_name": "example", "icon": "example", "id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0", "last_name": "example" }, "user_id": "2489E9AD-2EE2-8E00-8EC9-32D5F69181C0"}Unauthorized
Forbidden
Not found