> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List connections

> List API-visible connections in your Markifact team workspace.

Returns shared connections owned by your team, plus private connections owned by the user who created the API key.

## Endpoint

```http theme={"dark"}
GET /v1/connections
```

## Query Parameters

| Parameter     | Type   | Required | Description                                                                     |
| ------------- | ------ | -------- | ------------------------------------------------------------------------------- |
| `external_id` | string | No       | Filter connections by the external ID you provided when creating the auth link. |
| `type`        | string | No       | Filter connections by connection type, such as `ga4`, `gads`, or `meta_ads`.    |

## Example Request

```bash theme={"dark"}
curl "https://api.markifact.com/v1/connections?external_id=customer_123&type=ga4" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

## Response

```json theme={"dark"}
[
  {
    "id": "1f2e3d4c-0000-0000-0000-000000000000",
    "type": "ga4",
    "display_name": "login@example.com",
    "external_id": "customer_123",
    "is_private": false,
    "created_at": 1764000000000,
    "updated_at": 1764000000000
  }
]
```

## Connection Object

| Field          | Type            | Description                                                     |
| -------------- | --------------- | --------------------------------------------------------------- |
| `id`           | string          | Public Markifact connection ID.                                 |
| `type`         | string          | Connection type.                                                |
| `display_name` | string or null  | Display name for the connection.                                |
| `external_id`  | string or null  | External ID from the auth link, if provided.                    |
| `is_private`   | boolean         | Whether the connection is private to the API key's owning user. |
| `created_at`   | integer or null | Created timestamp in milliseconds.                              |
| `updated_at`   | integer or null | Updated timestamp in milliseconds.                              |


## OpenAPI

````yaml GET /v1/connections
openapi: 3.1.0
info:
  title: Markifact API
  version: 1.0.0
  description: API for managing Markifact workspace connections.
servers:
  - url: https://api.markifact.com
security:
  - bearerAuth: []
paths:
  /v1/connections:
    get:
      tags:
        - Connections
      summary: List connections
      description: List API-visible connections in your Markifact team workspace.
      operationId: listConnections
      parameters:
        - name: external_id
          in: query
          required: false
          schema:
            type: string
          description: >-
            Filter connections by the external ID you provided when creating the
            auth link.
        - name: type
          in: query
          required: false
          schema:
            type: string
            example: ga4
          description: Filter connections by connection type.
      responses:
        '200':
          description: Connections returned.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Connection'
        '401':
          description: Invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Connection:
      type: object
      properties:
        id:
          type:
            - string
            - 'null'
          description: Public Markifact connection ID.
        type:
          type: string
          description: Connection type.
        display_name:
          type:
            - string
            - 'null'
        external_id:
          type:
            - string
            - 'null'
        is_private:
          type: boolean
        created_at:
          type:
            - integer
            - 'null'
          format: int64
        updated_at:
          type:
            - integer
            - 'null'
          format: int64
      required:
        - id
        - type
        - is_private
    Error:
      type: object
      properties:
        detail: {}
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````