---
title: "Get Workspace Service Accounts"
method: GET
path: "/v1/service-accounts"
tags: ["workspace"]
---

# Get Workspace Service Accounts

`GET /v1/service-accounts`

## Request

- Base URL: `https://api.elevenlabs.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.elevenlabs.io/v1/service-accounts`
- Auth: none declared

List all service accounts in the workspace

## Headers

- `xi-api-key` string, nullable: Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

## Response `200`

Successful Response

- WorkspaceServiceAccountListResponseModel
  - `service-accounts` WorkspaceServiceAccountResponseModel[], required
    - `service_account_user_id` string, required
    - `name` string, required
    - `created_at_unix` integer, nullable
    - `api-keys` WorkspaceApiKeyResponseModel[], required
      - `name` string, required
      - `hint` string, required
      - `key_id` string, required
      - `service_account_user_id` string, required
      - `created_at_unix` integer, nullable
      - `is_disabled` boolean
      - `permissions` PermissionType[], nullable
      - `disable_reason` 'trial_ended' | 'subscription_downgrade' | 'exposed_publicly' | 'self_disabled'
      - `character_limit` integer, nullable: Maximum number of credits allowed in the current billing period.
      - `character_count` integer, nullable: Credits already used in the current billing period.
      - `hashed_xi_api_key` string, required
      - `allowed_ips` string[], nullable
      - `third_party_disable_allowed` boolean, nullable
      - `platform_limits` PlatformLimits: Unified container for all platform limits. Can be used by: - Billing groups (WorkspaceGroupDBModel.platform_limits) - Child workspaces (SubscriptionDBModel.platform_limits) - API keys (XiApiKeyMetadataDBModel.platform_limits) All fields are required when platform_limits exists. Use limit=None for unlimited.
        - `credits` StoredUsagePlatformLimit: Platform limit with usage stored in Firestore. Example: credit usage tracked in Firestore.
          - `limit` integer, nullable
          - `usage` integer: Current usage
        - `pvc` ComputedUsagePlatformLimit: Platform limit with usage computed externally. Example: PVCs use the count_owned_pro_voices_in_billing_group function to compute the usage.
          - `limit` integer, nullable
        - `concurrency` ComputedUsagePlatformLimit: Platform limit with usage computed externally. Example: PVCs use the count_owned_pro_voices_in_billing_group function to compute the usage.
          - `limit` integer, nullable
        - `dubbing_concurrency` ComputedUsagePlatformLimit: Platform limit with usage computed externally. Example: PVCs use the count_owned_pro_voices_in_billing_group function to compute the usage.
          - `limit` integer, nullable
        - `music_concurrency` ComputedUsagePlatformLimit: Platform limit with usage computed externally. Example: PVCs use the count_owned_pro_voices_in_billing_group function to compute the usage.
          - `limit` integer, nullable
      - `expires_at_unix` integer, nullable: Unix timestamp (seconds) after which this API key stops working. Null means the key never expires.
    - `default_sharing_groups` DefaultSharingGroupResponseModel[]
      - `group` WorkspaceGroupResponseModel, required
        - `name` string, required
        - `id` string, required
        - `members` string[], required
        - `permissions` WorkspaceGroupPermission[], nullable, required
        - `group_usage_limit` union
          - integer
          - 'unlimited'
        - `group_pvc_limit` union
          - integer
          - 'unlimited'
        - `group_concurrency_limit` union
          - integer
          - 'unlimited'
        - `group_dubbing_concurrency_limit` union
          - integer
          - 'unlimited'
        - `group_music_concurrency_limit` union
          - integer
          - 'unlimited'
        - `character_count` integer, nullable
        - `is_scim_synced` boolean
        - `scim_group` ScimGroupResponseModel
          - `scim_external_id` string, nullable, required
          - `display_name` string, required
          - `created_at_unix` integer, nullable
          - `updated_at_unix` integer, nullable
          - `seat_type` 'workspace_admin' | 'workspace_member' | 'workspace_lite_member': Seat types for workspace members.
        - `scim_frozen` boolean
      - `permission_level` 'admin' | 'editor' | 'viewer', required: The permission level to grant to the group

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-26** `169936a30a2d`: 1 info
  - added the optional property `service-accounts/items/api-keys/items/expires_at_unix` to the response with the `200` status
- **2026-10-15** `7caa31372b10`: 3 info
  - added the optional property `service-accounts/items/default_sharing_groups/items/group/group_concurrency_limit` to the response with the `200` status
  - added the optional property `service-accounts/items/default_sharing_groups/items/group/group_dubbing_concurrency_limit` to the response with the `200` status
  - added the optional property `service-accounts/items/default_sharing_groups/items/group/group_music_concurrency_limit` to the response with the `200` status
- **2026-10-11** `775d1f02f1a7`: 1 warning
  - added the new `all_resources_access` enum value to the `service-accounts/items/default_sharing_groups/items/group/permissions/anyOf[subschema #1]/items/` response property for the response status `200`
- **2026-10-08** `bfa9d7a4aa2a`: 2 warning
  - added the new `voice_collections_read` enum value to the `service-accounts/items/api-keys/items/permissions/anyOf[subschema #1]/items/` response property for the response status `200`
  - added the new `voice_collections_write` enum value to the `service-accounts/items/api-keys/items/permissions/anyOf[subschema #1]/items/` response property for the response status `200`
- …earlier changes not shown

[Operation history](https://skmtc.dev/elevenlabs/apis/elevenlabs-api-documentation/changes/v1/service-accounts/get.md)

---

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