Get closest service points

curl --request GET \
  --url https://api.smartsend.io/v2/teams/{teamUuid}/service-points/closest \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.smartsend.io/v2/teams/{teamUuid}/service-points/closest"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.smartsend.io/v2/teams/{teamUuid}/service-points/closest', 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.smartsend.io/v2/teams/{teamUuid}/service-points/closest",
  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.smartsend.io/v2/teams/{teamUuid}/service-points/closest"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.smartsend.io/v2/teams/{teamUuid}/service-points/closest")

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": [
    {
      "uuid": "019c4870-44a4-7a63-b9e8-f52cfed69fc2",
      "carrier": {
        "code": "postnord",
        "name": "PostNord",
        "logo_url": "https://assets.example.com/carriers/postnord/logo.svg",
        "icon_url": "https://assets.example.com/carriers/postnord/icon.svg"
      },
      "code": "12345",
      "name": "Example parcel shop",
      "type": "parcel_store",
      "address": {
        "address_lines": [
          "Example Street 12"
        ],
        "postal_code": "2200",
        "city": "Copenhagen",
        "country": "DK",
        "administrative_area": "84"
      },
      "coordinates": {
        "latitude": 55.689748,
        "longitude": 12.553726
      },
      "opening_hours": {
        "regular_opening_hours": [
          {
            "weekday": "monday",
            "periods": [
              {
                "opening_time": "08:00",
                "closing_time": "18:00"
              }
            ]
          },
          {
            "weekday": "tuesday",
            "periods": [
              {
                "opening_time": "08:00",
                "closing_time": "18:00"
              }
            ]
          },
          {
            "weekday": "wednesday",
            "periods": [
              {
                "opening_time": "08:00",
                "closing_time": "18:00"
              }
            ]
          },
          {
            "weekday": "thursday",
            "periods": [
              {
                "opening_time": "08:00",
                "closing_time": "18:00"
              }
            ]
          },
          {
            "weekday": "friday",
            "periods": [
              {
                "opening_time": "08:00",
                "closing_time": "18:00"
              }
            ]
          },
          {
            "weekday": "saturday",
            "periods": [
              {
                "opening_time": "10:00",
                "closing_time": "14:00"
              }
            ]
          },
          {
            "weekday": "sunday",
            "periods": [
              {
                "opening_time": "10:00",
                "closing_time": "14:00"
              }
            ]
          }
        ],
        "special_opening_hours": [
          {
            "is_closed": false,
            "start_date": "2026-12-24",
            "end_date": "2026-12-24",
            "open_time": "10:00",
            "close_time": "13:00"
          }
        ]
      },
      "distance": {
        "value": 250,
        "unit": "m"
      }
    }
  ],
  "links": {
    "first": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/service-points/closest?carrier=postnord&country=DK&postal_code=2200&per_page=1&page=1",
    "last": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/service-points/closest?carrier=postnord&country=DK&postal_code=2200&per_page=1&page=3",
    "prev": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/service-points/closest?carrier=postnord&country=DK&postal_code=2200&per_page=1&page=1",
    "next": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/service-points/closest?carrier=postnord&country=DK&postal_code=2200&per_page=1&page=3"
  },
  "meta": {
    "current_page": 2,
    "from": 2,
    "last_page": 3,
    "path": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/service-points/closest",
    "per_page": 1,
    "to": 2,
    "total": 3
  }
}

GET

teams

{teamUuid}

service-points

closest

Get closest service points

curl --request GET \
  --url https://api.smartsend.io/v2/teams/{teamUuid}/service-points/closest \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.smartsend.io/v2/teams/{teamUuid}/service-points/closest"

headers = {"Authorization": "Bearer <token>"}

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

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.smartsend.io/v2/teams/{teamUuid}/service-points/closest', 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.smartsend.io/v2/teams/{teamUuid}/service-points/closest",
  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.smartsend.io/v2/teams/{teamUuid}/service-points/closest"

	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))

}

require 'uri'
require 'net/http'

url = URI("https://api.smartsend.io/v2/teams/{teamUuid}/service-points/closest")

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": [
    {
      "uuid": "019c4870-44a4-7a63-b9e8-f52cfed69fc2",
      "carrier": {
        "code": "postnord",
        "name": "PostNord",
        "logo_url": "https://assets.example.com/carriers/postnord/logo.svg",
        "icon_url": "https://assets.example.com/carriers/postnord/icon.svg"
      },
      "code": "12345",
      "name": "Example parcel shop",
      "type": "parcel_store",
      "address": {
        "address_lines": [
          "Example Street 12"
        ],
        "postal_code": "2200",
        "city": "Copenhagen",
        "country": "DK",
        "administrative_area": "84"
      },
      "coordinates": {
        "latitude": 55.689748,
        "longitude": 12.553726
      },
      "opening_hours": {
        "regular_opening_hours": [
          {
            "weekday": "monday",
            "periods": [
              {
                "opening_time": "08:00",
                "closing_time": "18:00"
              }
            ]
          },
          {
            "weekday": "tuesday",
            "periods": [
              {
                "opening_time": "08:00",
                "closing_time": "18:00"
              }
            ]
          },
          {
            "weekday": "wednesday",
            "periods": [
              {
                "opening_time": "08:00",
                "closing_time": "18:00"
              }
            ]
          },
          {
            "weekday": "thursday",
            "periods": [
              {
                "opening_time": "08:00",
                "closing_time": "18:00"
              }
            ]
          },
          {
            "weekday": "friday",
            "periods": [
              {
                "opening_time": "08:00",
                "closing_time": "18:00"
              }
            ]
          },
          {
            "weekday": "saturday",
            "periods": [
              {
                "opening_time": "10:00",
                "closing_time": "14:00"
              }
            ]
          },
          {
            "weekday": "sunday",
            "periods": [
              {
                "opening_time": "10:00",
                "closing_time": "14:00"
              }
            ]
          }
        ],
        "special_opening_hours": [
          {
            "is_closed": false,
            "start_date": "2026-12-24",
            "end_date": "2026-12-24",
            "open_time": "10:00",
            "close_time": "13:00"
          }
        ]
      },
      "distance": {
        "value": 250,
        "unit": "m"
      }
    }
  ],
  "links": {
    "first": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/service-points/closest?carrier=postnord&country=DK&postal_code=2200&per_page=1&page=1",
    "last": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/service-points/closest?carrier=postnord&country=DK&postal_code=2200&per_page=1&page=3",
    "prev": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/service-points/closest?carrier=postnord&country=DK&postal_code=2200&per_page=1&page=1",
    "next": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/service-points/closest?carrier=postnord&country=DK&postal_code=2200&per_page=1&page=3"
  },
  "meta": {
    "current_page": 2,
    "from": 2,
    "last_page": 3,
    "path": "https://api.smartsend.io/v2/teams/00000000-0000-4000-8000-000000000001/service-points/closest",
    "per_page": 1,
    "to": 2,
    "total": 3
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Accept-Language

string

default:en

Preferred language(s) for translatable content using BCP 47 language tags. Supports quality values (q-factors) for priority ordering. The API negotiates the best available language based on this header, the team's configured language, and available translations. If omitted, the team's default language is used.

Example:

"da-DK, da;q=0.9, en;q=0.8"

Request-ID

string

Optional client-supplied request identifier. When provided and matching the validation pattern, the value is echoed back in the Request-ID response header. Otherwise the server generates one. Use this to correlate requests between client and server when reporting issues.

Required string length: 1 - 64

Pattern: ^[A-Za-z0-9._-]{1,64}$

Path Parameters

teamUuid

string<uuid>

required

Team uuid. All resources are scoped to this team.

Query Parameters

carrier

string

required

Known carrier code. Unknown codes return 422. A known carrier with no service points in the selected country is a valid filter and may return an empty result.

Examples:

"postnord"

"bring"

"dao"

"gls"

country

string

required

Valid ISO 3166-1 alpha-2 country code. Invalid codes return 422. A valid country with no service points for the selected carrier may return an empty result.

Required string length: 2

Examples:

"DK"

"SE"

"FI"

"NO"

"DE"

"ES"

"US"

"CN"

"CA"

postal_code

string

required

Postal/ZIP code

city

string

City name (improves accuracy)

street

string

Street address (improves accuracy)

query

string

Search query to filter service points by name or address

min_latitude

number

Southern boundary, inclusive. Must be less than or equal to max_latitude. Uses WGS 84 coordinates in decimal degrees. If any bounding-box coordinate is supplied, all four query parameters (min_latitude, max_latitude, min_longitude and max_longitude) are required. Omit all four to search without a bounding-box restriction. Missing, null, empty, out-of-range or reversed coordinates return 422.

Required range: -90 <= x <= 90

max_latitude

number

Northern boundary, inclusive. Must be greater than or equal to min_latitude. Uses WGS 84 coordinates in decimal degrees. If any bounding-box coordinate is supplied, all four query parameters (min_latitude, max_latitude, min_longitude and max_longitude) are required. Omit all four to search without a bounding-box restriction. Missing, null, empty, out-of-range or reversed coordinates return 422.

Required range: -90 <= x <= 90

min_longitude

number

Western boundary, inclusive. Must be less than or equal to max_longitude. Longitude intervals must not wrap across the antimeridian. Uses WGS 84 coordinates in decimal degrees. If any bounding-box coordinate is supplied, all four query parameters (min_latitude, max_latitude, min_longitude and max_longitude) are required. Omit all four to search without a bounding-box restriction. Missing, null, empty, out-of-range or reversed coordinates return 422.

Required range: -180 <= x <= 180

max_longitude

number

Eastern boundary, inclusive. Must be greater than or equal to min_longitude. Longitude intervals must not wrap across the antimeridian. Uses WGS 84 coordinates in decimal degrees. If any bounding-box coordinate is supplied, all four query parameters (min_latitude, max_latitude, min_longitude and max_longitude) are required. Omit all four to search without a bounding-box restriction. Missing, null, empty, out-of-range or reversed coordinates return 422.

Required range: -180 <= x <= 180

page

integer

default:1

Page number, starting at 1. Omit it to retrieve the first page.

Required range: x >= 1

per_page

integer

default:10

Number of service points per page. Keep the search address and all filters unchanged when following pagination links.

Required range: 1 <= x <= 50

Response

Service points ordered by increasing distance, with UUID as the tie-breaker. Filters, including the bounding box, are applied before pagination. The data array is empty when no points match, including for a known carrier with no service points in the selected valid country.

data

object[]

required

Show child attributes

links

object

required

Navigation links for a page-paginated collection. URLs preserve the selected filters and page size. First and last URLs are present even when the collection is empty; unavailable previous and next pages are null.

Show child attributes

API Reference

API v1

API v2

Get closest service points

Authorizations

Headers

Path Parameters

Query Parameters

Response