# Retrieve Connection List

Gets the list of connections.

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

## Path parameters:

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

## Query parameters:

  - `name` (string)
    The name of the Connection.

  - `country` (string)
    The country that the Connection is based in.

  - `parentUri` (string)
    The parent Uri if set.

  - `publicUri` (string)
    This is the public organisation URI.

  - `hasPublicUri` (boolean)
    Will return all connections where they have a public URI.

  - `recordState` (string)
    The record 'State' of the Connection
    Enum: "ACTIVE", "ARCHIVED"

  - `connectStatus` (string)
    Whether or not the Connection has an established link between their Interu account and yours.
    Enum: "CONNECTED", "DISCONNECTED"

  - `size` (integer)
    The number of elements to return in each page. Minimum value must be 1, defaults to 20.

  - `page` (integer)
    The pageNo to return. (Zero-based)

## Response 200 fields (application/json):

  - `content` (array, required)

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

  - `content.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.

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

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

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

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

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

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

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

  - `content.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"

  - `content.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"

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

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

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

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

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

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

  - `page` (object, required)

  - `page.size` (integer, required)

  - `page.totalElements` (integer, required)

  - `page.totalPages` (integer, required)


## Response 401 fields

## Response 403 fields

## Response 429 fields

## Response 500 fields