---
title: List Connected Connectors
---

# List Connected Connectors

Get all connected personal connectors for the current user.


{% api-container %}
{% api-content %}
{% endpoint method="GET" path="https://api.aitronos.com/v1/personal-connectors?organizationId={organizationId}" /%}

#### Query Parameters

**`organization_id`** string <em style="color: #ef4444 !important; font-weight: 600 !important; font-style: normal !important;">required</em>
Organization ID (e.g., `org_722dd7...`).

## Returns

A list of connected personal connector instances with their metadata.
{% /api-content %}
{% api-examples %}
{% tabs %}
{% tab label="Request" %}

{% code-group mode="dropdown" %}
```bash
curl "https://api.aitronos.com/v1/personal-connectors?organizationId=org_722dd7..." \
  -H "X-API-Key: $FREDDY_API_KEY"
```

```python
import requests
import os

api_key = os.environ.get("FREDDY_API_KEY")
headers = {
    "X-API-Key": api_key
}

response = requests.get(
    "https://api.aitronos.com/v1/personal-connectors",
    params={
        "organization_id": "org_722dd7..."
    },
    headers=headers
)

connectors = response.json()
print(f"Found {len(connectors)} connectors")
```

```javascript
const response = await fetch(
  'https://api.aitronos.com/v1/personal-connectors?organizationId=org_722dd7...',
  {
    headers: {
      'X-API-Key': process.env.FREDDY_API_KEY
    }
  }
);

const connectors = await response.json();
console.log(`Found ${connectors.length} connectors`);
```
{% /code-group %}

{% /tab %}
{% /tabs %}

---

**Response:**

{% tabs %}
{% tab label="200 OK" %}

```json
[
  {
    "connector_id": "pcon_abc123",
    "connector_type": "atlassian",
    "account_email": "user@example.com",
    "is_active": true,
    "last_sync_at": "2025-11-14T10:30:00Z",
    "created_at": "2025-11-10T08:00:00Z",
    "mcp_configuration_id": "mcp_xyz789"
  },
  {
    "connector_id": "pcon_def456",
    "connector_type": "github",
    "account_email": "developer@example.com",
    "is_active": false,
    "last_sync_at": "2025-11-12T15:45:00Z",
    "created_at": "2025-11-05T12:30:00Z",
    "mcp_configuration_id": "mcp_abc123"
  }
]
```

{% /tab %}
{% tab label="400 Bad Request" %}

```json
{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters",
    "system_message": "Validation failed",
    "type": "validation_error",
    "status": 400,
    "trace_id": "req_xyz789",
    "timestamp": "2025-11-13T10:30:00Z",
    "details": {}
  }
}
```

{% /tab %}
{% tab label="401 Unauthorized" %}

```json
{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_REQUIRED",
    "message": "Authentication required. Please provide a valid API key.",
    "system_message": "Missing or invalid authorization header",
    "type": "authentication_error",
    "status": 401,
    "trace_id": "req_abc123",
    "timestamp": "2025-11-13T10:30:00Z",
    "details": {}
  }
}
```

{% /tab %}
{% tab label="403 Forbidden" %}

```json
{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_PERMISSIONS",
    "message": "You do not have permission to perform this action.",
    "system_message": "Insufficient permissions",
    "type": "authorization_error",
    "status": 403,
    "trace_id": "req_def456",
    "timestamp": "2025-11-13T10:30:00Z",
    "details": {}
  }
}
```

{% /tab %}
{% tab label="429 Rate Limit" %}

```json
{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests. Please try again later.",
    "system_message": "Rate limit exceeded for endpoint",
    "type": "rate_limit_error",
    "status": 429,
    "details": {
      "retry_after": 60,
      "limit": 100,
      "remaining": 0,
      "reset_at": "2025-11-13T10:31:00Z"
    },
    "trace_id": "req_ghi789",
    "timestamp": "2025-11-13T10:30:00Z"
  }
}
```

{% /tab %}
{% tab label="500 Server Error" %}

```json
{
  "success": false,
  "error": {
    "code": "INTERNAL_ERROR",
    "message": "An unexpected error occurred. Please try again later.",
    "system_message": "Database connection timeout",
    "type": "server_error",
    "status": 500,
    "trace_id": "req_jkl012",
    "timestamp": "2025-11-13T10:30:00Z",
    "details": {}
  }
}
```

{% /tab %}
{% /tabs %}
{% /api-examples %}
{% /api-container %}

---

## Related Resources

- [List Available Connectors](./available.md)
- [Initiate OAuth Authorization](./authorize.md)
- [List Connector Tools](./tools.md)