# List ActivePieces connections for a project

`GET /api/integration/activepieces/connections/{integrationId}`

Authentication (security requirement alternatives):

```json
[
  {
    "bearer": []
  }
]
```

- bearer: http (bearer), header JWT. Enter JWT token

Parameters:

- `integrationId` (path, string, required) - Integration UUID
  Type: string

- `projectId` (query, string, required) - Activepieces project ID
  Type: string
  
  Example:
  
  ```json
  "project-123"
  ```

- `cursor` (query, string, optional) - Pagination cursor
  Type: string
  
  Example:
  
  ```json
  "cursor-abc123"
  ```

- `scope` (query, string, optional) - Connection scope
  Type: string
  
  enum: ["PROJECT"]
  
  Example:
  
  ```json
  "PROJECT"
  ```

- `pieceName` (query, string, optional) - Filter by piece name
  Type: string
  
  Example:
  
  ```json
  "slack"
  ```

- `displayName` (query, string, optional) - Filter by display name
  Type: string
  
  Example:
  
  ```json
  "My Slack Connection"
  ```

- `status` (query, string, optional) - Filter by connection status
  Type: string
  
  enum: ["ACTIVE","ERROR"]
  
  Example:
  
  ```json
  "ACTIVE"
  ```

- `limit` (query, number, optional) - Number of results to return
  Type: number
  
  default: 10
  
  minimum: 1
  
  maximum: 100
  
  Example:
  
  ```json
  10
  ```

Responses:

- 200: Returns list of ActivePieces connections

## Examples

### cURL

```bash
curl -X GET 'http://localhost:3000/api/integration/activepieces/connections/string?projectId=project-123&limit=10' \
  -H 'Authorization: Bearer YOUR_TOKEN'
```

### JavaScript

```javascript
const response = await fetch('http://localhost:3000/api/integration/activepieces/connections/string?projectId=project-123&limit=10', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_TOKEN',
  },
});

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

### Python

```python
import requests

response = requests.get(
    'http://localhost:3000/api/integration/activepieces/connections/string?projectId=project-123&limit=10',
    headers={
        'Authorization': 'Bearer YOUR_TOKEN',
    },
)
print(response.text)
```