> ## Documentation Index > Fetch the complete documentation index at: https://docs.talqui.chat/llms.txt > Use this file to discover all available pages before exploring further. # List operator tenants > Lists every tenant the authenticated operator is a member of, with each tenant's full settings — what backs the tenant switcher after login. Takes no parameters: the result is scoped by the caller's identity, which is also what decides which `:tenantID` the rest of the API will accept from them. Superusers are **not** exempt — they get the tenants they belong to, not every tenant on the platform. ## OpenAPI ````yaml /api/services-api.yaml get /v1/tenants openapi: 3.0.3 info: description: >- Talqui is an omnichannel customer service platform that unifies conversations from WhatsApp, Instagram, Telegram, and many other channels into a single attendant panel, alongside a broader ecosystem of plugins and integrations. This API gives developers programmatic access to Talqui's services layer, exposing the operations needed to read and manage tenants, conversations, plugins, and related resources that power that platform. Authentication is available on behalf of an Operator (the default for this API), a Plugin Connection, or a Plugin — see the [Talqui authentication guide](https://docs.talqui.chat/guides/introduction/authentication/) for how each token is obtained and when to use it. Need help or have questions not covered here? Reach out to support@talqui.com. license: name: ISC url: https://opensource.org/license/isc-license-txt title: Talqui - Services API version: 0.65.0 servers: - description: Production url: https://services-api.talqui.chat security: [] tags: - name: Tenants - name: Settings - name: Analytics - name: Campaigns - name: Campaigns models - name: Contacts - name: Handoff links - name: Inboxes - name: Messages - name: Notifications - name: Sessions - name: Operators - name: Plugins - name: Setup - name: Uploads paths: /v1/tenants: get: tags: - Tenants summary: List operator tenants description: >- Lists every tenant the authenticated operator is a member of, with each tenant's full settings — what backs the tenant switcher after login. Takes no parameters: the result is scoped by the caller's identity, which is also what decides which `:tenantID` the rest of the API will accept from them. Superusers are **not** exempt — they get the tenants they belong to, not every tenant on the platform. operationId: ListOperatorTenantsController parameters: [] responses: '200': content: application/json: schema: additionalProperties: false properties: data: additionalProperties: false properties: tenants: description: Tenants the authenticated operator belongs to. items: additionalProperties: false properties: createdAt: description: When the tenant was created. format: date-time type: string createdBy: description: Operator who created the tenant. type: string lastSignInAt: description: When somebody last signed in to this tenant. format: date-time nullable: true type: string organizationID: description: The Talqui organization this tenant belongs to. type: string ownerID: description: The operator who owns the tenant. type: string subscriptionID: description: Billing subscription, when the tenant has one. nullable: true type: string tenantDescription: description: Free-text description. type: string tenantID: description: The tenant identifier. type: string tenantLogo: description: Logo URL, when set. nullable: true type: string tenantMeta: additionalProperties: {} description: Arbitrary metadata attached to the tenant. type: object tenantName: description: Display name. type: string tenantOperatorRoles: additionalProperties: false description: Role groups inside the tenant. properties: managers: description: >- Operators holding the manager role in this tenant. items: type: string type: array owners: description: >- Operators holding the owner role in this tenant. items: type: string type: array required: - owners - managers type: object tenantOperatorsIDs: description: Every operator who is a member of this tenant. items: type: string type: array tenantSettings: additionalProperties: {} description: >- Tenant configuration bag: sessions, routing, messages, business hours and inbox visibility. type: object tenantWebsite: description: The tenant public website. type: string updatedAt: description: When the tenant was last updated. format: date-time type: string updatedBy: description: Operator who last updated the tenant. type: string required: - tenantID - organizationID - tenantName - tenantDescription - tenantWebsite - tenantLogo - tenantOperatorsIDs - tenantOperatorRoles - tenantMeta - ownerID - createdAt - updatedAt type: object type: array required: - tenants type: object required: - data type: object description: Response for status 200. '400': content: application/json: schema: properties: errors: items: $ref: '#/components/schemas/MissingOperatorIDError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: >- MissingOperatorIDError (error_code 1063): the resolved identity carries no operatorID. '401': content: application/json: schema: properties: errors: items: $ref: '#/components/schemas/UnauthorizedError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: 'UnauthorizedError (error_code 1003): missing/invalid operator token.' '500': content: application/json: schema: properties: errors: items: $ref: '#/components/schemas/UnknownError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: >- UnknownError (error_code 5999): Unexpected internal error not otherwise documented for this endpoint. components: schemas: MissingOperatorIDError: additionalProperties: false properties: error: enum: - MissingOperatorIDError type: string error_code: enum: - 1063 type: number message: example: operatorID is required. type: string statusCode: enum: - 400 type: number required: - statusCode - error - error_code - message type: object UnauthorizedError: additionalProperties: false properties: error: enum: - UnauthorizedError type: string error_code: enum: - 1003 type: number message: example: You are not authorized to perform this request. type: string statusCode: enum: - 401 type: number required: - statusCode - error - error_code - message type: object UnknownError: additionalProperties: false properties: error: enum: - UnknownError type: string error_code: enum: - 5999 type: number message: example: For some unknown reason your request has not succeeded. type: string statusCode: enum: - 500 type: number required: - statusCode - error - error_code - message type: object ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.