# Get all plugin-tag relationships

`GET /api/plugin-tags`

Retrieve a paginated list of plugin-tag relationships with optional filtering by plugin, tag, or tenant/organization. Use ?aggregate=count for count aggregation.

Authentication: no security requirement declared for this operation.

Parameters:

- `tenant` (query, object, optional)
  Type: object
  
  Schema: [Object](https://sourcey-gauzy.pages.dev/api-reference/models/object/index.md)

- `tenantId` (query, string, optional)
  Type: string

- `organization` (query, object, optional)
  Type: object
  
  Schema: [Object](https://sourcey-gauzy.pages.dev/api-reference/models/object/index.md)

- `organizationId` (query, string, optional)
  Type: string

- `sentTo` (query, string, optional)
  Type: string

- `pluginId` (query, string, uuid, optional) - Filter by plugin ID
  Type: string, uuid

- `tagId` (query, string, uuid, optional) - Filter by tag ID
  Type: string, uuid

- `pluginIds` (query, array, optional) - Filter by multiple plugin IDs (comma-separated)
  Type: array
  
  Example:
  
  ```json
  [
    "123e4567-e89b-12d3-a456-426614174000",
    "987fcdeb-51a2-43d1-9f4e-123456789abc"
  ]
  ```
  
  Items:
    Type: string

- `tagIds` (query, array, optional) - Filter by multiple tag IDs (comma-separated)
  Type: array
  
  Example:
  
  ```json
  [
    "456e7890-f12b-34c5-d678-901234567def",
    "abc12345-6789-def0-1234-56789abcdef0"
  ]
  ```
  
  Items:
    Type: string

- `aggregate` (query, string, optional) - Type of aggregation: count (redirects to count endpoint)
  Type: string

Responses:

- 200: Successfully retrieved plugin-tag relationships

Content type: application/json

Type: array

Items:
  Reference: [PluginTag](https://sourcey-gauzy.pages.dev/api-reference/models/plugintag/index.md); Type: object

## Examples

### cURL

```bash
curl -X GET 'http://localhost:3000/api/plugin-tags'
```

### JavaScript

```javascript
const response = await fetch('http://localhost:3000/api/plugin-tags', {
  method: 'GET',
});

const data = await response.text();
```

### Python

```python
import requests

response = requests.get('http://localhost:3000/api/plugin-tags')
print(response.text)
```