# List all data connectors

Returns a paginated list of all data connectors for the workspace, ordered by most recently updated first. Data connectors allow workflows and AI agents to make HTTP requests to external APIs.
OAuth tokens must have the `read_workflow_connector_execution_result` or `read_write_data_connectors` scope.

Endpoint: GET /data_connectors
Version: 2.18
Security: bearerAuth

## Query parameters:

  - `per_page` (integer)
    The number of results to return per page. Defaults to 20, minimum 1, maximum 50.

  - `starting_after` (string)
    The cursor value from `pages.next.starting_after` in a previous response. Used to paginate through results.

## Header parameters:

  - `Intercom-Version` (string)

## Response 200 fields (application/json):

  - `type` (string)
    The type of object - `list`.
    Enum: "list"

  - `data` (array)
    An array of data connector objects.

  - `data.type` (string)
    The type of object - `data_connector`.
    Enum: "data_connector"

  - `data.id` (string)
    The unique identifier for the data connector.
    Example: 12345

  - `data.name` (string)
    The name of the data connector.
    Example: Order Status Service

  - `data.description` (string)
    A description of what this data connector does.
    Example: Fetches order status from external fulfillment API

  - `data.internal_description` (string)
    The internal description of the data connector.

  - `data.state` (string)
    The current state of the data connector.
    Enum: "draft", "live"

  - `data.http_method` (string)
    The HTTP method used by the data connector.
    Enum: "get", "post", "put", "delete", "patch"

  - `data.enforce_auth` (boolean)
    Whether authentication is enforced for this connector.
    Example: true

  - `data.direct_fin_usage` (boolean)
    Whether this data connector is assigned to Fin for direct usage.
    Example: false

  - `data.created_by_admin_id` (string)
    The ID of the admin who created this data connector.
    Example: 12345

  - `data.updated_by_admin_id` (string)
    The ID of the admin who last updated this data connector.
    Example: 12345

  - `data.created_at` (string)
    The time the data connector was created.
    Example: 2025-11-15T09:30:00Z

  - `data.updated_at` (string)
    The time the data connector was last updated.
    Example: 2026-01-20T14:22:15Z

  - `data.execution_results_url` (string)
    The URL path to fetch execution results for this connector.
    Example: /data_connectors/12345/execution_results

  - `pages` (object)
    Pagination information.

  - `pages.type` (string)
    Enum: "pages"

  - `pages.per_page` (integer)
    The number of results per page.
    Example: 20

  - `pages.next` (object)
    Cursor for the next page of results.

  - `pages.next.starting_after` (string)
    The cursor value to use for the next page.
    Example: WzE3Njg5MTg5MzUuMCwxMjM0NSxudWxsXQ==

## Response 400 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

## Response 401 fields (application/json):

  - `type` (string, required)
    The type is error.list
    Example: error.list

  - `request_id` (string)
    Example: f93ecfa8-d08a-4325-8694-89aeb89c8f85

  - `errors` (array, required)
    An array of one or more error objects

  - `errors.code` (string, required)
    A string indicating the kind of error, used to further qualify the HTTP response code.
    Example: unauthorized

  - `errors.message` (string)
    Optional. Human readable description of the error.
    Example: Access Token Invalid

