> ## 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": 1764000000,
    "updated_at": 1764000000
  }
]
```

## 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 | Creation time as a Unix timestamp in seconds. |
| `updated_at` | integer or null | Last update time as a Unix timestamp in seconds. |


## 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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.