---
title: "List connections"
method: GET
path: "/api/v2/product-analytics/{entity}/mapping/connections"
tags: ["Rum Audience Management"]
---

# List connections

`GET /api/v2/product-analytics/{entity}/mapping/connections`

## Request

- Base URL: `https://api.datadoghq.com`
- URL: `https://api.datadoghq.com/api/v2/product-analytics/{entity}/mapping/connections`
- Auth: one of:
  - API key in header `DD-API-KEY` and API key in header `DD-APPLICATION-KEY`
  - OAuth 2
    - Authorization code: `/oauth2/v1/authorize`
    - Token URL: `/oauth2/v1/token`

List all data connections for an entity

## Path parameters

- `entity` string, required

## Response `200`

Successful response with list of connections

- ListConnectionsResponse: Response containing the list of all data source connections configured for an entity.
  - `data` ListConnectionsResponseData: The data object containing the resource type and attributes for the list connections response.
    - `attributes` ListConnectionsResponseDataAttributes: Attributes of the list connections response, containing the collection of data source connections.
      - `connections` ListConnectionsResponseDataAttributesConnectionsItems[]: The list of data source connections configured for the entity.
        - `created_at` string, date-time: Timestamp indicating when the connection was created.
        - `created_by` string: Identifier of the user who created the connection.
        - `fields` CreateConnectionRequestDataAttributesFieldsItems[]: List of custom attribute fields imported from the data source.
          - `description` string: Human-readable explanation of what the field represents.
          - `display_name` string: The human-readable label for the field shown in the UI.
          - `groups` string[]: List of group labels used to categorize the field.
          - `id` string, required: The unique identifier for the field within the connection.
          - `source_name` string, required: The name of the column or attribute in the source data system that maps to this field.
          - `type` string, required: The data type of the field (for example, string or number).
        - `id` string: Unique identifier of the connection.
        - `join` ListConnectionsResponseDataAttributesConnectionsItemsJoin: The join configuration describing how the data source is linked to the entity.
          - `attribute` string: The entity attribute used as the join key to link records from the data source.
          - `type` string: The type of join key used (for example, email or user_id).
        - `metadata` object: Additional key-value metadata associated with the connection.
        - `type` string: The type of data source connection (for example, ref_table).
        - `updated_at` string, date-time: Timestamp indicating when the connection was last updated.
        - `updated_by` string: Identifier of the user who last updated the connection.
    - `id` string: Unique identifier for the list connections response resource.
    - `type` 'list_connections_response', required: List connections response resource type.

## Other responses

- `429`: Too many requests

---

[API](https://skmtc.dev/datadog/apis/datadog-api-v2-collection.md) - [All operations](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/llms.txt) - [OpenAPI document](https://skmtc.dev/datadog/apis/datadog-api-v2-collection/revisions/da68bf029e4c?raw)