curl --request GET \
--url https://api-dev.narrative.io/v2/connections \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-dev.narrative.io/v2/connections"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-dev.narrative.io/v2/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-dev.narrative.io/v2/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 => [
"Authorization: Bearer <token>"
],
]);
$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-dev.narrative.io/v2/connections"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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-dev.narrative.io/v2/connections")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-dev.narrative.io/v2/connections")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"records": [
{
"type": "connections_dataset",
"id": "21691f26-f308-4e98-896c-579db27da04b",
"app": {
"id": 500,
"name": "S3 Connector"
},
"created_at": "2026-07-14T00:00:00Z",
"dataset_id": 42,
"installation_id": 9000,
"quick_settings": {
"bucket_suffix": "/my-subscription",
"number_of_files": "5"
},
"profile_id": "d555f07f-f140-40d2-91af-e6aa54f7488b",
"profile": {
"id": "d555f07f-f140-40d2-91af-e6aa54f7488b",
"name": "Production"
},
"status": "active"
}
]
}{
"error": "Unauthorized",
"error_description": "You are not authorized to use this endpoint."
}<string>List connections
Lists the calling company’s active connections, optionally filtered by app, connection type, dataset, model, or profile. Filters combine with AND. An app token only ever sees its own app’s connections, so app_id has no effect when one is used. The list is not paged.
curl --request GET \
--url https://api-dev.narrative.io/v2/connections \
--header 'Authorization: Bearer <token>'import requests
url = "https://api-dev.narrative.io/v2/connections"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-dev.narrative.io/v2/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-dev.narrative.io/v2/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 => [
"Authorization: Bearer <token>"
],
]);
$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-dev.narrative.io/v2/connections"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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-dev.narrative.io/v2/connections")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api-dev.narrative.io/v2/connections")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"records": [
{
"type": "connections_dataset",
"id": "21691f26-f308-4e98-896c-579db27da04b",
"app": {
"id": 500,
"name": "S3 Connector"
},
"created_at": "2026-07-14T00:00:00Z",
"dataset_id": 42,
"installation_id": 9000,
"quick_settings": {
"bucket_suffix": "/my-subscription",
"number_of_files": "5"
},
"profile_id": "d555f07f-f140-40d2-91af-e6aa54f7488b",
"profile": {
"id": "d555f07f-f140-40d2-91af-e6aa54f7488b",
"name": "Production"
},
"status": "active"
}
]
}{
"error": "Unauthorized",
"error_description": "You are not authorized to use this endpoint."
}<string>Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Only return connections to this app.
Only return connections of this type.
dataset, model Only return connections from this dataset.
Only return connections from this model.
Only return connections created against this app profile.
Response
OK
Every matching connection. The list is not paged.
A connection from a dataset or a model to a connector app. type says which, and only the matching id field (dataset_id or model_id) is sent.
- Option 1
- Option 2
Show child attributes
Show child attributes
{
"type": "connections_dataset",
"id": "21691f26-f308-4e98-896c-579db27da04b",
"app": { "id": 500, "name": "S3 Connector" },
"created_at": "2026-07-14T00:00:00Z",
"dataset_id": 42,
"installation_id": 9000,
"quick_settings": {
"bucket_suffix": "/my-subscription",
"number_of_files": "5"
},
"profile_id": "d555f07f-f140-40d2-91af-e6aa54f7488b",
"profile": {
"id": "d555f07f-f140-40d2-91af-e6aa54f7488b",
"name": "Production"
},
"status": "active"
}
Was this page helpful?

