get connection by id

Prerequisites

The caller must provide a connection id.

Authorization

API key (via the X-API-KEY header).

Parameters

Path Parameters

Field name	Description	Format
id	Connection ID	UUID

Query Parameters

Field name	Description	Format
usage	Show usage	Boolean

Response Body

Field name	Description	Format
id	Connection ID	UUID
name	The name of the connection	String
connector	The type of connector	String
description	Connection description	String
profiles	Connection profiles	Map
modifiedAt	The date and time of modification	String
modifiedBy	Modified by	String
createdAt	The date and time of creation	String
createdBy	Created by	String
usage	Usage quantity	Integer

Profile Structure

| Field name   | Description    | Format      |
| :----------- | :------------- | :---------- |
| profileName  | Key            | String      |
| profileValue | Profile config | JsonElement |

Examples

mainframe-rpc

    {
      "id": "00000000-0000-0000-0000-000000000001",
      "name": "connection-mainframe-rpc",
      "connector": "mainFrameRpc",
      "description": "example mainframe-rpc connection",
      "profiles": {
        "$default": {
          "baseUrl": "http://cics.example.internal",
          "uriMap": "/example/latest",
          "port": "12345",
          "codePage": "cp037"
        }
      },
      "modifiedAt": "2026-01-01T00:00:00.000000Z",
      "modifiedBy": "John Doe",
      "createdAt": "2026-01-01T00:00:00.000000Z",
      "createdBy": "John Doe",
      "usage": 0
    }
    ```

  

#### as400-rpc

```json Response
    {
      "id": "00000000-0000-0000-0000-000000000002",
      "name": "connection-as400-rpc",
      "connector": "as400Rpc",
      "description": "example as400-rpc connection",
      "profiles": {
        "$default": {
          "codePage": "037",
          "host": "ibmi.example.internal",
          "user": "example-user",
          "password": "'{cipher}a1b2c3d4e5f67890'"
        }
      },
      "modifiedAt": "2026-01-01T00:00:00.000000Z",
      "modifiedBy": "John Doe",
      "createdAt": "2026-01-01T00:00:00.000000Z",
      "createdBy": "John Doe",
      "usage": 0
    }
    ```

  

#### ims-rpc

```json Response
    {
      "id": "00000000-0000-0000-0000-000000000003",
      "name": "connection-ims-rpc",
      "connector": "imsRpc",
      "description": "example ims-rpc connection",
      "profiles": {
        "$default": {
          "host": "cics.example.internal",
          "username": "example-username",
          "password": "'{cipher}a1b2c3d4e5f67890'",
          "groupName": "GROUP1",
          "dataStoreName": "IVP1",
          "port": 9999,
          "codePage": "cp037",
          "sslProperties": {
            "isSslEnabled": false
          },
          "transactionProperties": {
            "commitMode": "SEND_AND_COMMIT"
          }
        }
      },
      "modifiedAt": "2026-01-01T00:00:00.000000Z",
      "modifiedBy": "John Doe",
      "createdAt": "2026-01-01T00:00:00.000000Z",
      "createdBy": "John Doe",
      "usage": 0
    }
    ```