Retrieve a list of sender addresses
curl --request GET \
--url https://panel.sendcloud.sc/api/v3/addresses/sender-addresses \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://panel.sendcloud.sc/api/v3/addresses/sender-addresses"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://panel.sendcloud.sc/api/v3/addresses/sender-addresses', 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://panel.sendcloud.sc/api/v3/addresses/sender-addresses",
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: 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://panel.sendcloud.sc/api/v3/addresses/sender-addresses"
req, _ := http.NewRequest("GET", url, nil)
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://panel.sendcloud.sc/api/v3/addresses/sender-addresses")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://panel.sendcloud.sc/api/v3/addresses/sender-addresses")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"data": [
{
"city": "Eindhoven",
"company_name": "Sendcloud",
"name": "John Doe",
"country_code": "NL",
"state_province_code": "null",
"email": "johndoe@sendcloud.com",
"house_number": "10",
"id": 1,
"address_line_2": "",
"postal_code": "5611 EM",
"address_line_1": "Stadhuisplein",
"phone_number": "+31626262626",
"tax_numbers": [
{
"name": "VAT",
"country_code": "NL",
"value": "NL123456789B01"
},
{
"name": "EORI",
"country_code": "NL",
"value": "NL123456789"
},
{
"name": "VAT",
"country_code": "GB",
"value": "GB123456789"
},
{
"name": "EORI",
"country_code": "GB",
"value": "GB987654312000"
},
{
"name": "IOSS",
"country_code": "NL",
"value": "IM1234567890"
}
],
"signature": {
"full_name": "John Doe",
"initials": "JD"
}
},
{
"city": "Antwerp",
"company_name": "Sendcloud",
"name": "Frits-Hendrik Joep",
"country_code": "BE",
"state_province_code": "null",
"email": "johndoe@sendcloud.com",
"house_number": "123",
"id": 2,
"address_line_2": "",
"postal_code": "XXXX CV",
"address_line_1": "Klapstraat",
"phone_number": "+32626262626",
"tax_numbers": [
{
"name": "VAT",
"country_code": "NL",
"value": "NL123456789B01"
},
{
"name": "EORI",
"country_code": "NL",
"value": "NL123456789"
},
{
"name": "VAT",
"country_code": "GB",
"value": "GB123456789"
},
{
"name": "EORI",
"country_code": "GB",
"value": "GB987654312000"
},
{
"name": "IOSS",
"country_code": "NL",
"value": "IM1234567890"
}
],
"signature": {
"full_name": "John Doe",
"initials": "JD"
}
}
]
}Sender addresses
Retrieve a list of sender addresses
Returns a list of all the sender addresses which have been saved to your account.
This endpoint uses cursor-based pagination via Link headers. See Pagination for details.
GET
/
addresses
/
sender-addresses
Retrieve a list of sender addresses
curl --request GET \
--url https://panel.sendcloud.sc/api/v3/addresses/sender-addresses \
--header 'Authorization: Basic <encoded-value>'import requests
url = "https://panel.sendcloud.sc/api/v3/addresses/sender-addresses"
headers = {"Authorization": "Basic <encoded-value>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};
fetch('https://panel.sendcloud.sc/api/v3/addresses/sender-addresses', 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://panel.sendcloud.sc/api/v3/addresses/sender-addresses",
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: 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://panel.sendcloud.sc/api/v3/addresses/sender-addresses"
req, _ := http.NewRequest("GET", url, nil)
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://panel.sendcloud.sc/api/v3/addresses/sender-addresses")
.header("Authorization", "Basic <encoded-value>")
.asString();require 'uri'
require 'net/http'
url = URI("https://panel.sendcloud.sc/api/v3/addresses/sender-addresses")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'
response = http.request(request)
puts response.read_body{
"data": [
{
"city": "Eindhoven",
"company_name": "Sendcloud",
"name": "John Doe",
"country_code": "NL",
"state_province_code": "null",
"email": "johndoe@sendcloud.com",
"house_number": "10",
"id": 1,
"address_line_2": "",
"postal_code": "5611 EM",
"address_line_1": "Stadhuisplein",
"phone_number": "+31626262626",
"tax_numbers": [
{
"name": "VAT",
"country_code": "NL",
"value": "NL123456789B01"
},
{
"name": "EORI",
"country_code": "NL",
"value": "NL123456789"
},
{
"name": "VAT",
"country_code": "GB",
"value": "GB123456789"
},
{
"name": "EORI",
"country_code": "GB",
"value": "GB987654312000"
},
{
"name": "IOSS",
"country_code": "NL",
"value": "IM1234567890"
}
],
"signature": {
"full_name": "John Doe",
"initials": "JD"
}
},
{
"city": "Antwerp",
"company_name": "Sendcloud",
"name": "Frits-Hendrik Joep",
"country_code": "BE",
"state_province_code": "null",
"email": "johndoe@sendcloud.com",
"house_number": "123",
"id": 2,
"address_line_2": "",
"postal_code": "XXXX CV",
"address_line_1": "Klapstraat",
"phone_number": "+32626262626",
"tax_numbers": [
{
"name": "VAT",
"country_code": "NL",
"value": "NL123456789B01"
},
{
"name": "EORI",
"country_code": "NL",
"value": "NL123456789"
},
{
"name": "VAT",
"country_code": "GB",
"value": "GB123456789"
},
{
"name": "EORI",
"country_code": "GB",
"value": "GB987654312000"
},
{
"name": "IOSS",
"country_code": "NL",
"value": "IM1234567890"
}
],
"signature": {
"full_name": "John Doe",
"initials": "JD"
}
}
]
}OAuth2 scopes required:
read:parcel. See Scopes for OAuth apps.Authorizations
HTTPBasicAuthOAuth2ClientCreds
Query Parameters
The cursor query string is used as the pivot value to filter results. If no value is provided, the first page of results will be returned. To get this value, you must encode the offset, reverse and position into a base64 string.
There are 3 possible parameters to encode:
o: Offsetr: Reversep: Position
For example, r=1&p=300 encoded as a base64 string would be cj0xJnA9MzAw. The query string would then be cursor=cj0xJnA9MzAw.
Example:
"cj0xJnA9MzAw"