> ## Documentation Index
> Fetch the complete documentation index at: https://www.text.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# List accounts
> Accounts are listed by using `organization_id` obtained from the access token.
**Required scopes:** `accounts--all:ro`, `accounts.roles--all:ro`
## OpenAPI
````yaml /api/global-accounts/openapi.json get /accounts
openapi: 3.0.0
info:
title: Global Accounts API
description: >-
API used to manage Organizations and Accounts for multiple products. Also
responsible for authorization and authentication processes.
version: 2.0.0
servers:
- url: https://accounts.livechat.com/v2
description: Main production server URL
security: []
paths:
/accounts:
get:
tags:
- Accounts
summary: List accounts
description: >-
Accounts are listed by using `organization_id` obtained from the access
token.
responses:
'200':
description: 'OK: Returns the list of accounts.'
content:
application/json:
schema:
type: array
items:
allOf:
- description: An entity of the account, used across all Text products.
type: object
required:
- email
properties:
account_id:
type: string
format: uuid
readOnly: true
description: Unique account identifier.
name:
type: string
description: >-
The account name (nick; first name, second name, or
both).
exclusiveMaximum: false
maxLength: 191
email:
type: string
format: email
description: The account's email address.
exclusiveMaximum: false
maxLength: 128
email_verified:
type: boolean
readOnly: true
description: >-
If `true`: the account's email was verified via an
email action or by a third-party identity provider.
default_product:
type: string
description: The default product for the account.
enum:
- LiveChat
- Accounts
- ChatBot
- HelpDesk
- OpenWidget
default_organization_id:
type: string
format: uuid
description: >-
The ID of the default organization the account
belongs to.
default: null
nullable: true
avatar_url:
type: string
description: >-
The "Account's avatar" field has been deprecated and
is no longer recommended for use; instead, the
avatar functionality has been relocated to the
account organization settings.
default: null
nullable: true
exclusiveMaximum: false
maxLength: 255
deprecated: true
roles:
type: array
items:
description: >-
Role groups account scopes into one permission
entity.
type: object
properties:
role_id:
type: string
description: Unique role definition ID.
product:
type: string
description: The product the role belongs to.
enum:
- LiveChat
- Accounts
- ChatBot
- HelpDesk
- OpenWidget
role:
type: string
description: >-
The role name; can be one of the predefined
roles or a custom role name.
enum:
- owner
- viceowner
- administrator
- normal
- member
type:
type: string
readOnly: true
description: >-
The role type: `primary` is an obligatory
accounts role, `secondary` is a basic product
role, `custom` is a custom-defined role.
predefined:
readOnly: true
type: boolean
description: >-
If `true`: the role is common across all
organizations. If `false`: the role is
specific to an organization.
description: >-
Roles associated with the account; returned only
when the access token contains the
`accounts.roles--all:ro` scope.
updated_at:
readOnly: true
type: string
format: date-time
description: The date of the account's last update.
created_at:
readOnly: true
type: string
format: date-time
description: The date the account was created.
- type: object
properties:
properties:
type: object
allOf:
- type: object
description: >-
A nullable object that holds account properties
and statuses, with the properties being specific
to the organization and dependent on the
`organization_id` value obtained through
authorization.
properties:
active:
type: boolean
description: >-
If `true`: the account has already logged
into the organization.
mfa:
type: boolean
description: 'If `true`: the account has MFA turned on.'
productName:
type: object
description: Specific product properties.
properties:
suspended:
type: boolean
description: >-
If `true`: the account is suspended in a
specific product.
avatar_url:
description: >-
Organization-specific avatar url. The same
value is returned from the account
organization settings.
type: string
format: url
nullable: true
example:
- account_id: 496a94f2-cbbf-444e-a3cb-305b9f5f8cbb
name: John
email: john@example.com
email_verified: false
default_product: LiveChat
default_organization_id: b2185556-634c-4ecf-b4c9-bcf8b65bc853
avatar_url: null
roles:
- role_id: 728b99be-848c-11ea-9b91-005056a007e9
product: LiveChat
role: administrator
type: primary
predefined: true
properties:
active: true
mfa: true
avatar_url: >-
https://api.text.com/file/accounts/avatars/b2185556-634c-4ecf-b4c9-bcf8b65bc853/ae5bd37f-64b2-416b-bbb3-4623f53e6fb8/37a190dd-77a5-4fba-a7d3-2e89eab0e8fd.jpg
updated_at: '2026-06-03T10:53:04.000Z'
created_at: '2026-06-03T10:53:04.000Z'
'401':
description: Unauthorized, missing, or invalid authorization.
content:
application/json:
schema:
allOf:
- description: The default error object.
type: object
properties:
error:
description: The error code.
type: string
enum:
- bad_request
- invalid_request
- unauthorized_client
- unauthorized
- access_denied
- unsupported_response_type
- invalid_scope
- server_error
- temporarily_unavailable
- unsupported_grant_type
- invalid_grant
- invalid_client
- conflict
- resource_not_found
- join_link_expired
- traffic_blocked
- not_implemented
error_description:
type: string
sub_error:
description: The error subcode.
type: string
nullable: true
request_id:
description: Unique request identifier.
type: string
format: uuid
- type: object
properties:
error:
type: string
error_description:
type: string
example:
error: unauthorized
error_description: The account is not authorized.
request_id: 5903c51b-89f0-41a9-a25d-4f39af100353
'403':
description: 'Forbidden: Insufficient scope.'
content:
application/json:
schema:
allOf:
- description: The default error object.
type: object
properties:
error:
description: The error code.
type: string
enum:
- bad_request
- invalid_request
- unauthorized_client
- unauthorized
- access_denied
- unsupported_response_type
- invalid_scope
- server_error
- temporarily_unavailable
- unsupported_grant_type
- invalid_grant
- invalid_client
- conflict
- resource_not_found
- join_link_expired
- traffic_blocked
- not_implemented
error_description:
type: string
sub_error:
description: The error subcode.
type: string
nullable: true
request_id:
description: Unique request identifier.
type: string
format: uuid
- type: object
properties:
error:
type: string
sub_error:
type: string
error_description:
type: string
example:
error: access_denied
sub_error: insufficient_scope
error_description: The resource owner or authorization server denied the request.
request_id: 5903c51b-89f0-41a9-a25d-4f39af100353
'500':
description: Server Error.
content:
application/json:
schema:
allOf:
- description: The default error object.
type: object
properties:
error:
description: The error code.
type: string
enum:
- bad_request
- invalid_request
- unauthorized_client
- unauthorized
- access_denied
- unsupported_response_type
- invalid_scope
- server_error
- temporarily_unavailable
- unsupported_grant_type
- invalid_grant
- invalid_client
- conflict
- resource_not_found
- join_link_expired
- traffic_blocked
- not_implemented
error_description:
type: string
sub_error:
description: The error subcode.
type: string
nullable: true
request_id:
description: Unique request identifier.
type: string
format: uuid
- type: object
properties:
error:
type: string
error_description:
type: string
example:
error: server_error
error_description: >-
The server encountered an unexpected condition that prevented
it from fulfilling the request.
request_id: 5903c51b-89f0-41a9-a25d-4f39af100353
security:
- PersonalAccessToken: []
- OAuth2BearerToken:
- accounts--all:ro
- accounts.roles--all:ro
components:
securitySchemes:
PersonalAccessToken:
description: >-
Use your `account ID` as the username and your personal access token
(PAT) as the password, or pass a Base64-encoded value directly in the
Authorization header. For more information, see the personal access tokens
guide.
type: http
scheme: basic
OAuth2BearerToken:
description: >-
This API uses OAuth2 with the implicit grant flow. Learn about
the implicit grant flow.
type: oauth2
flows:
implicit:
authorizationUrl: https://accounts.livechat.com
scopes: {}
authorizationCode:
authorizationUrl: https://accounts.livechat.com
tokenUrl: https://accounts.livechat.com/token
scopes: {}
````