# Retrieve Connection

Retrieve an existing connection.

Endpoint: GET /organisations/{orgId}/connections/{connectionId}
Version: v2_28
Security: ApiKeyAuth

## Path parameters:

  - `connectionId` (string, required)

  - `orgId` (string, required)
    The organisation identity

## Response 200 fields (application/json):

  - `name` (string, required)
    The name of the connected organisation.

  - `publicUri` (string)
    This is the public organisation URI. Once organisation is on the system as well and are connected then this will be populated. Before that happens an organisation can record for themselves but later have them linked if a given organisation then signs up.

  - `parentUri` (string)
    If this connection is actually part of your group of companies then this should point to your organisation URI.

  - `website` (string)
    The corporate website for this organisation.

  - `email` (string)
    Contact email address for the organisation.

  - `address` (object, required)
    The address of the corporate headquarters.

  - `address.street` (string)
    The mainline of the address.

  - `address.region` (string)
    Region of the address.

  - `address.zipCode` (string)
    Zip/postal code for the address.

  - `address.country` (string, required)
    Alpha-2 code of the ISO 3166 Country Codes specification.
    Enum: "AF", "AX", "AL", "DZ", "AS", "AD", "AO", "AI", "AQ", "AG", "AR", "AM", "AW", "AU", "AT", "AZ", "BS", "BH", "BD", "BB", "BY", "BE", "BZ", "BJ", "BM", "BT", "BO", "BA", "BW", "BV", "BR", "VG", "IO", "BN", "BG", "BF", "BI", "KH", "CM", "CA", "CV", "KY", "CF", "TD", "CL", "CN", "HK", "MO", "CX", "CC", "CO", "KM", "CG", "CD", "CK", "CR", "CI", "HR", "CU", "CY", "CZ", "DK", "DJ", "DM", "DO", "EC", "EG", "SV", "GQ", "ER", "EE", "ET", "FK", "FO", "FJ", "FI", "FR", "GF", "PF", "TF", "GA", "GM", "GE", "DE", "GH", "GI", "GR", "GL", "GD", "GP", "GU", "GT", "GG", "GN", "GW", "GY", "HT", "HM", "VA", "HN", "HU", "IS", "IN", "ID", "IR", "IQ", "IE", "IM", "IL", "IT", "JM", "JP", "JE", "JO", "KZ", "KE", "KI", "KP", "KR", "KW", "KG", "LA", "LV", "LB", "LS", "LR", "LY", "LI", "LT", "LU", "MK", "MG", "MW", "MY", "MV", "ML", "MT", "MH", "MQ", "MR", "MU", "YT", "MX", "FM", "MD", "MC", "MN", "ME", "MS", "MA", "MZ", "MM", "NA", "NR", "NP", "NL", "AN", "NC", "NZ", "NI", "NE", "NG", "NU", "NF", "MP", "NO", "OM", "PK", "PW", "PS", "PA", "PG", "PY", "PE", "PH", "PN", "PL", "PT", "PR", "QA", "RE", "RO", "RU", "RW", "BL", "SH", "KN", "LC", "MF", "PM", "VC", "WS", "SM", "ST", "SA", "SN", "RS", "SC", "SL", "SG", "SK", "SI", "SB", "SO", "ZA", "GS", "SS", "ES", "LK", "SD", "SR", "SJ", "SZ", "SE", "CH", "SY", "TW", "TJ", "TZ", "TH", "TL", "TG", "TK", "TO", "TT", "TN", "TR", "TM", "TC", "TV", "UG", "UA", "AE", "GB", "US", "UM", "UY", "UZ", "VU", "VE", "VN", "VI", "WF", "EH", "YE", "ZM", "ZW"

  - `connectStatus` (string, required)
    This is the status of connection to the organisation. In order to send records to or receive record from an organisation the two organisations must be connected.
    Enum: "CONNECTED", "DISCONNECTED"

  - `connectStatusUpdatedTime` (string)
    The time and date when the connection status was updated.

  - `id` (string)
    System assigned or user defined id field.

  - `createdBy` (string)
    User who created the record.

  - `createdTime` (string)
    Date & Time that the record was created.

  - `updatedBy` (string)
    Last updated by user.

  - `updatedTime` (string)
    Date & Time that the record was last updated.


## Response 401 fields

## Response 403 fields

## Response 404 fields

## Response 429 fields

## Response 500 fields