---
title: "List All Connections"
method: GET
path: "/workspaces/{workspace_id}/projects/{project_id}/connections"
tags: ["Connections"]
---

# List All Connections

`GET /workspaces/{workspace_id}/projects/{project_id}/connections`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/workspaces/{workspace_id}/projects/{project_id}/connections`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

Bulk, all-connector-types connections list for a project, with live source/destination usage counts

## Path parameters

- `workspace_id` integer, required: Workspace refers to a collection of projects. Workspace ID is unique identifier for workspace.
- `project_id` integer, required: Project ID of the workspace

## Query parameters

- `limit` integer: Max rows to return in bulk mode
- `offset` integer: Rows to skip in bulk mode

## Response `200`

Bulk connections list across every connector type

- BulkConnectionsListSchema
  - `connections` BulkConnectionSchema[], required
    - `id` string, required
    - `name` string, required
    - `connector_type` string, required
    - `managed_by` 'external' | 'mammoth', required
    - `deletable` boolean, required
    - `connection_key` string, nullable
    - `connector_key` string, nullable
    - `health_status` 'healthy' | 'unreachable' | 'unknown' | 'null', nullable
    - `health_checked_at` string, date-time, nullable
    - `last_test_failure` string, nullable
    - `source_count` integer, required
    - `dest_count` integer, required
    - `source_usages` SourceUsageSchema[], nullable
      - `datasource_id` integer, required
    - `dest_usages` DestUsageSchema[], nullable
      - `dataview_id` integer, required
      - `action_id` integer, nullable
      - `publish_id` integer, nullable
    - `created_by` integer, nullable
    - `created_at` string, date-time, nullable
    - `connection_meta` ConnectionMetaSchema
      - `auth_method` string, nullable
      - `auth_fields` string[], nullable
      - `encryption` string, nullable
      - `host` string, nullable
      - `port` union
        - integer
        - string
      - `database` string, nullable
      - `username` string, nullable
  - `total` integer, required

## Other responses

- `400`: Bad Request
- `401`: Authorization error
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/fe078afe239b?raw)
