Get an EmailOctopus list and its fields
curl --request GET \
--url https://api.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}', 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.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}",
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.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}"
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.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}")
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{
"data": {
"list": {
"id": "example-newsletter",
"name": "Example newsletter",
"doubleOptIn": false,
"fields": [
{
"tag": "FirstName",
"type": "TEXT",
"label": "First name",
"fallback": null
}
],
"tags": [
"research"
],
"counts": {
"pending": 0,
"subscribed": 12,
"unsubscribed": 1
}
},
"sourceFields": [
"firstName",
"lastName",
"fullName",
"jobTitle",
"headline",
"seniority",
"department",
"linkedinUrl",
"company.name",
"company.domain",
"company.industry",
"company.industryGroup",
"company.revenueRange",
"company.linkedinUrl",
"geo.city",
"geo.state",
"geo.country",
"intent.score",
"intent.topicOverlap",
"intent.matchedTopics"
]
},
"meta": {
"timestamp": "2026-01-15T12:00:00.000Z",
"request_id": "example-request"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}Integrations
Get an EmailOctopus list and its fields
Returns one EmailOctopus list, its destination fields, and supported source fields for mapping audience contacts. The connected account must be healthy and owned by the authenticated organization. Requires a non-viewer member using bearer authentication. Requests share a 120-per-60-second allowance per source IP within this integration, destination, or delivery route family.
GET
/
v1
/
intent
/
integrations
/
emailoctopus
/
lists
/
{listId}
Get an EmailOctopus list and its fields
curl --request GET \
--url https://api.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}', 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.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}",
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.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}"
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.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aws53.cloud/v1/intent/integrations/emailoctopus/lists/{listId}")
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{
"data": {
"list": {
"id": "example-newsletter",
"name": "Example newsletter",
"doubleOptIn": false,
"fields": [
{
"tag": "FirstName",
"type": "TEXT",
"label": "First name",
"fallback": null
}
],
"tags": [
"research"
],
"counts": {
"pending": 0,
"subscribed": 12,
"unsubscribed": 1
}
},
"sourceFields": [
"firstName",
"lastName",
"fullName",
"jobTitle",
"headline",
"seniority",
"department",
"linkedinUrl",
"company.name",
"company.domain",
"company.industry",
"company.industryGroup",
"company.revenueRange",
"company.linkedinUrl",
"geo.city",
"geo.state",
"geo.country",
"intent.score",
"intent.topicOverlap",
"intent.matchedTopics"
]
},
"meta": {
"timestamp": "2026-01-15T12:00:00.000Z",
"request_id": "example-request"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": "<unknown>"
},
"meta": {
"timestamp": "<string>",
"request_id": "<string>"
}
}Authorizations
bearerAuthapiKeyAuth
Dashboard access token. Send as Authorization: Bearer .
Path Parameters
EmailOctopus list identifier in the connected account.
Minimum string length:
1Example:
"example-newsletter"
Query Parameters
Healthy EmailOctopus connected account identifier in the authenticated organization.
Example:
"66666666-6666-4666-8666-666666666666"
Was this page helpful?