List Connections

Returns all connections in the account.

GET /connections

List Connections

cURL

curl --request GET \
  --url https://api.xplenty.com/{account_id}/api/connections \
  --header 'Accept: <accept>' \
  --header 'Authorization: Basic <encoded-value>'

import requests

url = "https://api.xplenty.com/{account_id}/api/connections"

headers = {
    "Accept": "<accept>",
    "Authorization": "Basic <encoded-value>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {Accept: '<accept>', Authorization: 'Basic <encoded-value>'}
};

fetch('https://api.xplenty.com/{account_id}/api/connections', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.xplenty.com/{account_id}/api/connections",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Accept: <accept>",
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.xplenty.com/{account_id}/api/connections"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Accept", "<accept>")
	req.Header.Add("Authorization", "Basic <encoded-value>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.xplenty.com/{account_id}/api/connections")
  .header("Accept", "<accept>")
  .header("Authorization", "Basic <encoded-value>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.xplenty.com/{account_id}/api/connections")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Accept"] = '<accept>'
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

200

[
  {
    "id": 123,
    "name": "<string>",
    "type": "<string>",
    "connection_group_id": 123,
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "url": "<string>"
  }
]

Authorizations

Authorization · string · header · required

Enter your API key as the username. Leave the password field blank. Example: curl -u YOUR_API_KEY: https://api.xplenty.com/...

Headers

Accept · string · default: application/vnd.xplenty+json; version=2 · required

API version header — required on all requests

Query Parameters

offset · integer · default: 0

Index of the first object to retrieve (starting from 0)

Required range: x >= 0

limit · integer · default: 20

Number of items to return (max 100)

Required range: 1 <= x <= 100

type · string

Filter by connection type

connection_group_id · string

Return only connections assigned to the given connection group. Pass the literal string null to return only connections that are not assigned to any connection group (the "ungrouped only" filter). Omit the parameter to return connections from every group.

Response

200 - application/vnd.xplenty+json; version=2

Successful response

id · integer

name · string

type · string

connection_group_id · integer | null

ID of the connection group this connection belongs to, or null if ungrouped.

created_at · string<date-time>

updated_at · string<date-time>

url · string<uri>