Get

[POST] .../v1/connectedintegration/get

Returns a list of integrations connected to the account. Use this method to retrieve connected integrations before editing their settings, checking external availability, reconnecting, disconnecting or opening an integration web UI. The response returns connected integration records with identifiers, activity state, owner and handler metadata, optional translated name/description, optional schedule data, webhook names and web_ui_url when the integration exposes a web interface. The request body is required; when is_public is omitted the API treats it as true, include_name defaults to true, include_schedule defaults to false and filters key, connected_integration_id, is_public, handler, handlers and user_id can narrow the list while keys and connected_integration_ids remain aliases. The current request user must have integration select access; missing body, denied access, invalid filters, database failures and integration lookup failures are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
filters Array of Filter Optional Optional filters by fields available for this API method.

Filterable Fields

Field Type Description
connected_integration_id string Connected integration ID array.
handler string Filter by the primary integration handler.
handlers string Filter by supported integration handlers. Does not replace handler.
is_public bool true for a public integration, false for a local integration.
key string
keys string Integration key array, where keys are system names.
user_id int ID of the user who created the local integration.

Request Example

{
  "filters": [
    {
      "field": "connected_integration_id",
      "operator": "Equal",
      "value": "c98210addc4f4e1bb50b17a8c1299a37"
    },
    {
      "field": "is_public",
      "operator": "Equal",
      "value": "true"
    },
    {
      "field": "handler",
      "operator": "Equal",
      "value": "MarketPlace"
    }
  ],
  "include_schedule": true,
  "include_name": true
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Array of IntegrationConnected Result array.

Response Example

{
  "ok": true,
  "result": [
    {
      "key": "UZUM_TEZKOR",
      "is_public": true,
      "connected_integration_id": "c98210addc4f4e1bb50b17a8c1299a37",
      "alias": "uzum-main",
      "owner": "Global",
      "handler": "MarketPlace",
      "handlers": [
        "MarketPlace",
        "Widget"
      ],
      "scheduled": true,
      "schedule": {
        "scheduler_uuid": "550e8400-e29b-41d4-a716-446655440000",
        "period_type": "Day",
        "period_value": 1,
        "last_execute": "2026-02-02 09:30:00"
      },
      "check_enabled": true,
      "is_active": true,
      "name": "Uzum Tezkor",
      "description": "Marketplace integration",
      "endpoint": "https://integration.example.uz",
      "webhooks": [
        "OrdersChanged"
      ],
      "image_url": "https://cdn.example.uz/integrations/uzum.png",
      "docs_url": "https://docs.example.uz/uzum",
      "version": "1.0.0",
      "has_web_ui": true,
      "proxy_enabled": true,
      "web_ui_url": "https://integration.example.uz/external/c98210addc4f4e1bb50b17a8c1299a37",
      "has_iap": false
    }
  ]
}