GET
/
connection
import Openint from '@openint/sdk';

const client = new Openint({
  token: process.env['OPENINT_API_KEY'], // This is the default and can be omitted
});

async function main() {
  // Automatically fetches more pages as needed.
  for await (const listConnectionsResponse of client.listConnections()) {
    console.log(listConnectionsResponse);
  }
}

main();
{
  "items": [
    {
      "id": "<string>",
      "customer_id": "<string>",
      "connector_config_id": "<string>",
      "integration_id": "<string>",
      "status_message": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "display_name": "<string>",
      "disabled": true,
      "status": "healthy",
      "metadata": {},
      "connector_name": "<string>",
      "settings": {
        "oauth": {
          "credentials": {
            "access_token": "<string>",
            "client_id": "<string>",
            "scope": "<string>",
            "refresh_token": "<string>",
            "expires_in": 123,
            "expires_at": "<string>",
            "token_type": "<string>",
            "raw": {}
          },
          "created_at": "<string>",
          "updated_at": "<string>",
          "last_fetched_at": "<string>",
          "metadata": {}
        },
        "access_token": "<string>",
        "subdomain": "<string>"
      },
      "connector": {
        "name": "<string>",
        "display_name": "<string>",
        "logo_url": "<string>",
        "stage": "alpha",
        "platforms": [
          "web"
        ],
        "schemas": {
          "connector_config": "<any>",
          "connection_settings": "<any>",
          "integration_data": "<any>",
          "webhook_input": "<any>",
          "pre_connect_input": "<any>",
          "connect_input": "<any>",
          "connect_output": "<any>"
        },
        "auth_type": "BASIC",
        "required_scopes": [
          "<string>"
        ],
        "openint_default_scopes": [
          "<string>"
        ],
        "openint_allowed_scopes": [
          "<string>"
        ],
        "scopes": [
          {
            "scope": "<string>",
            "display_name": "<string>",
            "description": "<string>"
          }
        ],
        "has_openint_credentials": true
      },
      "integration": {
        "id": "<string>",
        "standard": "<string>",
        "external": "<string>",
        "created_at": "<string>",
        "updated_at": "<string>",
        "connector_name": "accelo",
        "name": "<string>",
        "logo_url": "<string>",
        "stage": "alpha",
        "platforms": [
          "web"
        ],
        "category": "<string>",
        "auth_type": "<string>",
        "version": "<string>"
      }
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1,
  "has_next_page": true
}

Authorizations

Authorization
string
header
required

Organization API Key available in the settings page of the OpenInt Console or Customer API Key or Token Customer authentication token created using the create customer token API. It is passed in the authorization header with format: Bearer {token}

Query Parameters

limit
integer
default:50

Limit the number of items returned

Required range: 0 <= x <= 3000
offset
integer
default:0

Offset the items returned

Required range: x >= 0
connector_names
enum<string>[]
customer_id
string

The id of the customer in your application. Ensure it is unique for that customer.

connector_config_id
string

The id of the connector config, starts with ccfg_

include_secrets
boolean
expand
enum<string>[]

Expand the response with additional optionals

search_query
string
refresh_policy
enum<string>
default:none

Controls credential refresh: none (never), force (always), or auto (when expired, default)

Available options:
none,
force,
auto

Response

200
application/json

Successful response

The list of connections