--- title: "List" method: GET path: "/v3/integrations/search" tags: ["integrations-v3"] --- # List `GET /v3/integrations/search` ## Request - Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from) - URL: `https://api.traversal.com/v3/integrations/search` - Auth: none declared Search integration instances, with optional filtering. **Query parameters** (all optional): | Parameter | Description | |-----------|-------------| | ``id`` | Return only the instance with this UUID. | | ``integration_type`` | Filter by integration type (e.g. ``LogService``, ``opensearch``). | | ``organization_id`` | Scope to this org. Defaults to the caller's org. Cross-org queries require platform-admin. | | ``third_party_id`` | Filter by third-party system identifier (e.g. a LogService ID). | **Permissions**: org member, org setup user, or org admin (own org); platform admin (any org). Results are ordered by ``created_at`` descending. ## Query parameters - `id` string, nullable - `integration_type` 'anthropic' | 'openai' | 'gradient_ai' | 'datadog' | 'elasticsearch' | 'prometheus' | 'mimir' | 'victoria_metrics' | 'grafana' | 'appdynamics' | 'servicenow' | 'github' | 'github_webhook' | 'gitlab' | 'thousandeyes' | 'linear' | 'notion' | 'loki' | 'opensearch' | 'splunk' | 'gcp' | 'motherduck' | 'confluence' | 'coralogix' | 'firehydrant' | 'pagerduty' | 'slack' | 'teams' | 'jira' | 'kubernetes' | 'traversal' | 'traversal_webhook' | 'traversal_api_key' | 'incident_io' | 'sentry' | 'tempo' | 'alexandria' | 'honeycomb' | 'alertmanager' | 'emim' | 'trailblazer' | 'dynatrace' | 'cribl' | 'mcp' | 'aws_cli' | 'artifactory' | 'spinnaker' | 'amex_webex_captions' | 'deptracker' | 'do_service_catalog' | 'cloudwatch' | 'azure_devops' | 'azure': Canonical integration platform types. Represents the platform or system where data originates from. Used to determine appropriate connectors, authentication, and API clients. - `organization_id` string, nullable - `third_party_id` string, nullable ## Response `200` Successful Response - IntegrationInstanceResponse[] - `id` string, required: Stable UUID for this integration instance. Use this in PUT /v3/integrations/{id} and DELETE /v3/integrations/{id}. - `organization_id` string, required: UUID of the organization that owns this integration instance. - `name` string, required: Human-readable display name set at creation time. - `description` string, nullable: Optional free-text description of this integration instance. Surfaced to Traversal's AI during investigations to help it understand when and how to use this integration. - `type` 'anthropic' | 'openai' | 'gradient_ai' | 'datadog' | 'elasticsearch' | 'prometheus' | 'mimir' | 'victoria_metrics' | 'grafana' | 'appdynamics' | 'servicenow' | 'github' | 'github_webhook' | 'gitlab' | 'thousandeyes' | 'linear' | 'notion' | 'loki' | 'opensearch' | 'splunk' | 'gcp' | 'motherduck' | 'confluence' | 'coralogix' | 'firehydrant' | 'pagerduty' | 'slack' | 'teams' | 'jira' | 'kubernetes' | 'traversal' | 'traversal_webhook' | 'traversal_api_key' | 'incident_io' | 'sentry' | 'tempo' | 'alexandria' | 'honeycomb' | 'alertmanager' | 'emim' | 'trailblazer' | 'dynatrace' | 'cribl' | 'mcp' | 'aws_cli' | 'artifactory' | 'spinnaker' | 'amex_webex_captions' | 'deptracker' | 'do_service_catalog' | 'cloudwatch' | 'azure_devops' | 'azure', required: Canonical integration platform types. Represents the platform or system where data originates from. Used to determine appropriate connectors, authentication, and API clients. - `third_party_id` string, nullable: Optional opaque identifier from the third-party system (e.g. a Log Store instance ID). Populated automatically from the integration payload when present. - `enabled_data_types` string[], required: List of data-type capabilities enabled for this integration (e.g. ``["logs", "metrics"]``). Controlled by the integration payload. - `metadata` object: Non-secret integration-specific metadata stored with this instance. - `created_at` string, date-time, nullable: ISO-8601 timestamp of when this integration instance was created. - `updated_at` string, date-time, nullable: ISO-8601 timestamp of the most recent update to this instance. - `created_by` string, nullable: UUID of the user who created this integration instance, if known. - `last_health_check` HealthCheckResponse: Aggregate result of an integration's connection health check. - `status` 'pending' | 'connected' | 'partial' | 'failed', required: Overall status of a connection health check. - `steps` HealthCheckStepResponse[], required - `step` 'connectivity' | 'auth' | 'query', required: Identifies which health check step a result is for. - `passed` boolean, required - `message` string, required - `details` object - `checked_at` string, date-time, required - `connector_id` string, nullable: UUID of the org connector this instance routes through. Null when the instance connects over the public internet. - `network_access` string, nullable: Name of the network this integration connects through (e.g. an internal VPN). Null when the integration connects over the public internet. - `environment_labels` string[]: The customer's own names for the environments this integration's data covers, e.g. ``["prod", "staging"]``, normalized to lowercase. Empty when the instance has none. The single reserved value ``"unscoped"`` means the data is deliberately not split by environment, which is distinct from the empty list meaning nobody has labelled it yet. ## Other responses - `422`: Validation Error ## Changes > 66 revisions in range; 9 not diffed. - **2026-10-06** `31e1a8b7cf89`: 1 warning, 1 info - added the new `azure` enum value to the `items/type` response property for the response status `200` - added the enum value `azure` to the property `anyOf[subschema #1: IntegrationType]/` of the `query` request parameter `integration_type` - **2026-09-26** `75b9e4398c46`: 1 warning, 1 info - added the new `traversal` enum value to the `items/type` response property for the response status `200` - added the enum value `traversal` to the property `anyOf[subschema #1: IntegrationType]/` of the `query` request parameter `integration_type` - **2026-09-24** `2fc80b73eb41`: 1 warning, 1 info - added the new `pagerduty` enum value to the `items/type` response property for the response status `200` - added the enum value `pagerduty` to the property `anyOf[subschema #1: IntegrationType]/` of the `query` request parameter `integration_type` - **2026-09-23** `3da9c3d0385f`: 1 warning, 1 info - added the new `azure_devops` enum value to the `items/type` response property for the response status `200` - added the enum value `azure_devops` to the property `anyOf[subschema #1: IntegrationType]/` of the `query` request parameter `integration_type` - …earlier changes not shown [Operation history](https://skmtc.dev/traversal/apis/traversal-api/changes/v3/integrations/search/get.md) --- [API](https://skmtc.dev/traversal/apis/traversal-api.md) - [All operations](https://skmtc.dev/traversal/apis/traversal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/traversal/apis/traversal-api/revisions/31e1a8b7cf89?raw)