# List execution results for a data connector

Retrieve paginated execution logs for a specific data connector.
Results from the last hour are returned by default. Use `start_ts` and `end_ts` to customize the time range.
Request/response bodies are excluded by default. Use `include_bodies=true` to include them.
OAuth tokens must have the `read_workflow_connector_execution_result` or `read_write_data_connectors` scope.

Endpoint: GET /data_connectors/{data_connector_id}/execution_results
Version: 2.18
Security: bearerAuth

## Path parameters:

  - `data_connector_id` (string, required)
    The unique identifier for the data connector.

## Query parameters:

  - `per_page` (integer)
    The number of results per page (1-30, default 10).

  - `starting_after` (string)
    Cursor for pagination. Use the value from `pages.next.starting_after` in a previous response.

  - `success` (string)
    Filter by success status. Use `true`, `false`, or omit for all.

  - `error_type` (string)
    Filter by error type.

  - `start_ts` (integer)
    Unix timestamp for start of time range (default 1 hour ago).

  - `end_ts` (integer)
    Unix timestamp for end of time range (default now).

  - `include_bodies` (string)
    Include request/response bodies in the response (default false).

## Header parameters:

  - `Intercom-Version` (string)

## Response 200 fields (application/json):

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

  - `data` (array)
    An array of execution result objects.

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

  - `data.id` (string)
    The unique identifier for the execution result.
    Example: 99001

  - `data.data_connector_id` (string)
    The unique identifier of the data connector that produced this result.
    Example: 12345

  - `data.success` (boolean)
    Whether the execution was successful.
    Example: true

  - `data.http_status` (integer)
    The HTTP status code returned by the external API.
    Example: 200

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

  - `data.error_type` (string)
    The type of error that occurred, if any.
    Enum: "request_configuration_error", "faraday_error", "3rd_party_error", "response_mapping_error", "token_refresh_error", "fin_action_response_formatting_error", "fin_action_identity_verification_error", "email_verification_error", "non_fin_standalone_action_identity_verification_error", "request_validation_error", "client_side_action_error", "code_block_transformation_error", "otp_preview_not_supported_error"

  - `data.error_message` (string)
    A human-readable error message. Any http or https URLs in it are redacted the same way as `request_url`; the rest of the message is returned as is.
    Example: Connection refused

  - `data.execution_time_ms` (integer)
    The execution time in milliseconds.
    Example: 245

  - `data.source_type` (string)
    The type of source that triggered this execution.
    Enum: "custom_bot", "inbound_custom_bot", "button_custom_bot", "answer", "workflow", "saved_reply", "triggerable_custom_bot", "inbox", "fin", "synthetic_test"

  - `data.source_id` (string)
    The identifier of the source that triggered this execution.
    Example: 5001

  - `data.conversation_id` (string)
    The conversation associated with this execution, if any.
    Example: 8001

  - `data.created_at` (string)
    The time the execution occurred.
    Example: 2026-02-10T18:15:32Z

  - `data.request_url` (string)
    The request URL. Query parameters, userinfo, and fragments are redacted. For some hosts that put credentials in the path, the path is removed too. A suffix such as ` [query params redacted]` or ` [credentials redacted]` is appended when anything is redacted, and a URL that cannot be parsed becomes `[invalid URL redacted]`.
    Example: https://api.example.com/webhook

  - `data.request_body` (string)
    The request body sent to the external API.
    Example: {"message": "hello"}

  - `data.response_body` (string)
    The response body from the external API.
    Example: {"status": "ok"}

  - `data.raw_response_body` (string)
    The raw (unmapped) response body.
    Example: {"status": "ok"}

  - `pages` (object)
    Pagination information.

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

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

  - `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: WzE3NzA3NDU1MTUuMCw5OTAwMCxudWxsXQ==

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

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

