Skip to main content
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>'
{
  "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"
      }
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Basic Authentication using API key and secrets is currently the main authentication mechanism.

Query Parameters

​
cursor
string

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: Offset
  • r: Reverse
  • p: 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"

​
page_size
integer

The size of the page to fetch

Required range: x <= 100

Response

200 - application/json

List of sender addresses.

​
data
Address Object · object[]

A list of the users configured sender addresses.