# List vector stores

div
strong
🔨 In Development
 — This section is still being developed and may change.


Retrieve a list of all vector stores in an organization that the user has access to.

List all vector stores in an organization that the user has access to. Access is determined by the vector store's access mode (public, organization, department, or private) and the user's permissions.

#### Path Parameters

**`organization_id`** string required

The unique identifier of the organization.

## Returns

An array of [Vector Store objects](/docs/api-reference/objects/vector-store-object).

Request

```bash
curl "https://api.freddy.aitronos.com/v1/org_abc123/vector-stores" \
  -H "Authorization: Bearer $FREDDY_API_KEY"
```


```python
import requests

response = requests.get(
    "https://api.freddy.aitronos.com/v1/org_abc123/vector-stores",
    headers={"Authorization": f"Bearer {api_key}"}
)

stores = response.json()
print(f"Found {len(stores)} vector stores")
for store in stores:
    print(f"- {store['name']}: {store['fileCount']} files, {store['dataSize']} bytes")
```


```javascript
const response = await fetch('https://api.freddy.aitronos.com/v1/org_abc123/vector-stores', {
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const stores = await response.json();
console.log(`Found ${stores.length} vector stores`);
stores.forEach(store => {
  console.log(`- ${store.name}: ${store.fileCount} files, ${store.dataSize} bytes`);
});
```


```python
from freddy import FreddyClient

with FreddyClient(api_key="your-api-key") as client:
    stores = client.vector_stores.list(
        organization_id="org_abc123",
        page=1,
        page_size=20
    )
    
    print(f"Found {len(stores.data)} vector stores")
    for store in stores.data:
        print(f"- {store.name}: {store.file_count} files, {store.data_size} bytes")
```

## Response

200 OK

```json
[
  {
    "id": "vs_abc123",
    "name": "Product Documentation",
    "description": "Technical documentation for all products",
    "organizationId": "org_abc123",
    "isActive": true,
    "createdAt": "2025-01-15T10:30:00Z",
    "updatedAt": "2025-01-20T14:22:00Z",
    "createdBy": "uid_user123",
    "accessMode": "organization",
    "accessDepartments": null,
    "accessUsers": null,
    "fileCount": 42,
    "dataSize": 15728640
  },
  {
    "id": "vs_def456",
    "name": "Customer Support KB",
    "description": "Customer support knowledge base articles",
    "organizationId": "org_abc123",
    "isActive": true,
    "createdAt": "2025-01-10T08:15:00Z",
    "updatedAt": "2025-01-19T16:45:00Z",
    "createdBy": "uid_user456",
    "accessMode": "department",
    "accessDepartments": ["dept_support", "dept_sales"],
    "accessUsers": null,
    "fileCount": 128,
    "dataSize": 52428800
  },
  {
    "id": "vs_ghi789",
    "name": "Personal Research",
    "description": "Private research documents",
    "organizationId": "org_abc123",
    "isActive": true,
    "createdAt": "2025-01-18T12:00:00Z",
    "updatedAt": "2025-01-20T09:30:00Z",
    "createdBy": "uid_user123",
    "accessMode": "private",
    "accessDepartments": null,
    "accessUsers": ["uid_user123"],
    "fileCount": 8,
    "dataSize": 4194304
  }
]
```

Errors
**404 Not Found**


```json
{
  "error": {
    "message": "Organization not found",
    "type": "not_found_error",
    "code": "organization_not_found"
  }
}
```

**401 Unauthorized**


```json
{
  "error": {
    "message": "Authentication required",
    "type": "authentication_error",
    "code": "missing_authentication"
  }
}
```

**403 Forbidden**


```json
{
  "error": {
    "message": "Access denied to organization",
    "type": "permission_error",
    "code": "insufficient_permissions"
  }
}
```

**500 Server Error**


```json
{
  "error": {
    "message": "Internal server error",
    "type": "server_error",
    "code": "internal_error"
  }
}
```

## Related Resources

- [Create Vector Store](/docs/api-reference/vector-stores/create)
- [Retrieve Vector Store](/docs/api-reference/vector-stores/retrieve)
- [Vector Store Object](/docs/api-reference/objects/vector-store-object)