Intercom API (unofficial showcase)
GET/data_connectors/{data_connector_id}/execution_results

List execution results for a data connector

Lists paginated execution results for a specific data connector. Results cover the last hour by default; use start_ts and end_ts to change the time range and the filters to narrow the results. Request and response bodies are excluded unless you set include_bodies to true.

9 parameters
data_connector_idstringrequired
The unique identifier of the data connector whose execution results to list.
per_pageintegeroptional
Number of results per page, from 1 to 30. Defaults to 10 when omitted.
Default:10
starting_afterstringoptional
Pagination cursor from `pages.next.starting_after` in the previous response.
successstringoptional
Filter by success status using `true` or `false`; omit to include all results.
Allowed:truefalse
error_typestringoptional
Filter by error type, such as `request_configuration_error`, `faraday_error`, or `3rd_party_error`.
Allowed:request_configuration_errorfaraday_error3rd_party_errorresponse_mapping_errortoken_refresh_errorfin_action_response_formatting_errorfin_action_identity_verification_erroremail_verification_errornon_fin_standalone_action_identity_verification_errorrequest_validation_errorclient_side_action_error
start_tsintegeroptional
Unix timestamp for the start of the time range. Defaults to one hour ago when omitted.
end_tsintegeroptional
Unix timestamp for the end of the time range. Defaults to the current time when omitted.
include_bodiesstringoptional
Whether to include request and response bodies. Defaults to `false` when omitted.
Allowed:truefalse
Intercom-Versionstringoptional
The Intercom API version to use. Defaults to 2.17 when omitted.
Allowed:1.01.11.21.31.42.02.12.22.32.42.52.6Default:2.17

4 status codes
200Returns a paginated list of execution results with pagination information. Request and response bodies are included only when requested.
typestringoptional
The type of object - `list`.
Allowed:list
dataarray<DataConnectorExecutionResult>optional
An array of execution result objects.
pagesobjectoptional
Pagination information.
400Returned when a parameter is invalid.

One documented failure

  • parameter_invalid

    Invalid error_type. Must be one of: 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

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
401Returned when the request is unauthorized.

One documented failure

  • unauthorized

    Access Token Invalid

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects
404Returned when the data connector is not found.

One documented failure

  • data_connector_not_found

    Data connector not found

typestringrequired
The type is error.list
request_idstringoptional
errorsarray<object>required
An array of one or more error objects

Error handling

A 400 is returned for an invalid parameter, a 401 when the request is unauthorized, and a 404 when the data connector is not found. per_page must be from 1 to 30, and success and include_bodies accept true or false; use starting_after to continue pagination.