BizKitHub
DocsAPI ReferenceShipment/api/v1/shipment/delivery-point/search
getShipmentPublic API v1

/api/v1/shipment/delivery-point/search

Pickup points of a carrier (synced daily from the carrier). Use it to build the pickup point picker in your checkout, then send the chosen pointId as deliveryPointId on POST /order/create. With lat/lng the nearest points come first.

shipmentgetApiV1ShipmentDelivery-pointSearch

Parameters

8 query

Query parameters

· 8
carrier"gls"Required

Carrier code. Currently gls (ParcelShops and lockers, CZ + SK).

Default: glsValues: gls
Examplegls
countrystringOptional
Length: 2–2
ExampleCZ
querystringOptional

Words matched against name, street, city, ZIP and id.

ExampleBrno Lidická
latstringOptional
Example49.1951
lngstringOptional
Example16.6068
type"shop" | "locker"Optional
Default: shopValues: shoplocker
Exampleshop
codOnlystringOptional

true = only points accepting cash on delivery.

Exampleexample_codOnly
limitstringOptional

1 to 100, default 20.

Example20

Response schema

1 status code documented

200Success
itemsobject[]Required
Each array item:
carrierCodestringRequired
Examplegls
pointIdstringRequired

Send this value as deliveryPointId on POST /order/create.

ExampleCZ60200-PSHOP017
countrystringRequired
ExampleCZ
typestringRequired

shop (ParcelShop) or locker (parcel box).

Exampleshop
namestringRequired
ExamplePLODY MORAVY s.r.o.
streetstringRequired
ExampleLidická 45
citystringRequired
ExampleBrno
zipstringRequired
Example60200
latnumber | nullRequired
One of 2:
Variant 1
number
Variant 2
null
lngnumber | nullRequired
One of 2:
Variant 1
number
Variant 2
null
acceptsCodbooleanRequired

The point accepts cash on delivery parcels.

openingHoursobject[]Required
Each array item:
daynumberRequired

ISO weekday, 1 = Monday.

fromstringRequired
Example08:30
tostringRequired
Example18:00
isActivebooleanRequired

False when the point disappeared from the carrier list.

distanceKmnumberOptional

Distance from lat/lng, when they were sent.

Response example

application/json
{
  "items": [
    {
      "carrierCode": "gls",
      "pointId": "CZ60200-PSHOP017",
      "country": "CZ",
      "type": "shop",
      "name": "PLODY MORAVY s.r.o.",
      "street": "Lidická 45",
      "city": "Brno",
      "zip": "60200",
      "acceptsCod": false,
      "openingHours": [
        {
          "day": 0,
          "from": "08:30",
          "to": "18:00"
        }
      ],
      "isActive": false,
      "distanceKm": 0
    }
  ]
}

Request example

GET /api/v1/shipment/delivery-point/search

get
curl -X GET "https://api.bizkithub.com/api/v1/shipment/delivery-point/search?carrier=gls&country=CZ&query=Brno%20Lidick%C3%A1&lat=49.1951&lng=16.6068&type=shop&codOnly=example_codOnly&limit=20" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY"

Need an API key?

All BizKitHub public API endpoints require authentication via API key.

Get API Key