> ## 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 plugin connections by plugin > Lists every tenant that installed the **calling** plugin, with the connection each one configured — what a plugin polls to discover its own install base. Each row carries the connection's `token` and the tenant's provider credentials in `settings`, which is the point: the plugin needs them to act for that tenant. The plugin is identified by its own credential, so this route takes no parameters at all. There is deliberately no way to ask for another plugin's connections. ## OpenAPI ````yaml /api/services-api.yaml get /v1/plugins/connections 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/plugins/connections: get: tags: - Plugins summary: List plugin connections by plugin description: >- Lists every tenant that installed the **calling** plugin, with the connection each one configured — what a plugin polls to discover its own install base. Each row carries the connection's `token` and the tenant's provider credentials in `settings`, which is the point: the plugin needs them to act for that tenant. The plugin is identified by its own credential, so this route takes no parameters at all. There is deliberately no way to ask for another plugin's connections. operationId: ListPluginConnectionsByPluginController parameters: [] responses: '200': content: application/json: schema: additionalProperties: false properties: data: additionalProperties: false properties: pluginConnections: description: >- Connections of the calling plugin, one per tenant that installed it. items: additionalProperties: false properties: createdAt: description: When the connection was created. format: date-time type: string deadAt: description: >- When the connection turned DEAD, while it stays so. format: date-time nullable: true type: string deletedAt: description: >- Always absent here — deleted connections are not listed. format: date-time nullable: true type: string disabled: description: Whether the tenant switched this connection off. type: boolean lastAssertAt: description: When the connection was last asserted. format: date-time nullable: true type: string lastAssertStatus: description: Outcome of the last assertion run. enum: - PENDING - SUCCESS - FAILED type: string lastHealthCheckAt: description: When the connection was last health-checked. format: date-time nullable: true type: string lastHealthStatus: description: Resolved state of the last health check. enum: - HEALTHY - SICK - DEAD type: string nextAssertAt: description: When the next assertion is due. format: date-time nullable: true type: string nextHealthCheckAt: description: When the next health check is due. format: date-time nullable: true type: string pluginConnectionID: description: The connection identifier. type: string pluginConnectionLabel: description: Label the tenant gave this connection. nullable: true type: string pluginURN: description: URN of the plugin this connection installs. type: string settings: additionalProperties: {} description: >- Provider configuration for this connection, including its credentials. type: object sickAt: description: >- When the connection first turned SICK, while it stays so. format: date-time nullable: true type: string tenantID: description: The tenant that owns this connection. type: string token: description: >- Credential of this connection, used to authenticate as it. nullable: true type: string updatedAt: description: When the connection was last updated. format: date-time type: string required: - pluginConnectionID - pluginURN - tenantID - pluginConnectionLabel - token - settings - lastHealthStatus - lastHealthCheckAt - nextHealthCheckAt - lastAssertStatus - lastAssertAt - nextAssertAt - sickAt - deadAt - disabled - createdAt - updatedAt type: object type: array required: - pluginConnections type: object required: - data type: object description: Response for status 200. '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 plugin token.' '403': content: application/json: schema: properties: errors: items: $ref: '#/components/schemas/ForbiddenError' maxItems: 1 minItems: 1 type: array required: - errors type: object description: >- ForbiddenError (error_code 1004): caller is not a `Plugin` identity, or its identity carries no pluginURN. '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: 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 ForbiddenError: additionalProperties: false properties: error: enum: - ForbiddenError type: string error_code: enum: - 1004 type: number message: example: You do not have access to this resource. type: string statusCode: enum: - 403 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.