Points (Parcel Locker, ParcelPoint)

name 

String

Unique point name e.g. KRA007 (Parcel Locker)

type

Array

Table specifying types of points available at the location.

Possible types of points:

• parcel_locker - Physical parcel locker and parcel points to which you can send your parcel.

• pop - All parcel points.

• parcel_locker_only - Only physical parcel locker.

• parcel_locker_superpop - Parcel points which you can send your parcel. 

status 

String

Point status.

location

Object

Location object including the geographical location latitude and longitude

Location resource example in JSON format:

location_type

String

Location type.

location_description

String

Additional location description that may make it easier to reach.

location_description_1

String

Additional description

location_description_2

String

Additional description

distance

Integer

Distance from the relative point location. If the relative point has not been specified, takes null value.

opening_hours 

String

Point opening hours

address

Object

Address object containing the point's address information such as street, post-code, city.

Address object example in JSON format:

Object

Detailed point address data

phone_number 

String

Point telephone number

payment_point_descr 

String

Additional information about the point

functions

Array

Table specifying the functions offered by the point. Possible functions:

partner_id

Integer

ID of partner.

"partner_id":0 - Parcel Locker

"partner_id": 33 - ParcelPoint with parcel locker parcel pick-up function.

"partner_id": 30 - ParcelPoint without parcel locker parcel pick-up function, has only parcel post function.

is_next 

Boolean

Is it a NEXT automatic parcel station

payment_available 

Boolean

Availability of payment at a given point

There is a possibility of payment_available = true with payment_type = 0, it means the payment is available

payment_type 

String

Payment type parameter

virtual 

Integer

Virtual point

recommended_low_interest_box_machines_list 

Array

Other points recommended nearby

location_247 

Boolean

Is the parcel locker available 24/7 (Parcel lockers with the parameter set to true are dedicated service points for the Weekend Parcels service).

physical_type_mapped

String

Type of parcel locker

easy_access_zone

String

Description for type of parcel locker

supported_locker_temperatures

Integer

Parcel locker with controlled temperature.

Available values:
"supported_locker_temperatures": [4]
"supported_locker_temperatures": [20]
"supported_locker_temperatures": [4, 20]

name

String
Array

Searches for shipments with given name.

Searches for shipments with given names.

?name=KRA02APP
?name=KRA02APP,ADA01N

type

String
Array

Searches for shipments with given type.

Searches for shipments with given types.

?type=parcel_locker
?type=parcel_locker,pop

functions

String
Array

Searches for shipments with given function.

Searches for shipments with given functions.

?functions=parcel
?functions=parcel,parcel_send

partner_id

Integer
Array

Searches for shipments with given partner ID.

Searches for shipments with given partner IDs.

?partner_id=1
?partner_id=1,2

is_next

Boolean

Searches for NEXT parcel locker points

?is_next=true

payment_available 

Boolean

Searches by payment availability at the point

?payment_available=true

post_code

String
Array

Searches for shipments with given post code.

Searches for shipments with given post codes.

?post_code=11-111
?post_code=11-111,22-222

city

String
Array

Searches for shipments with given city.

Searches for shipments with given cities.

?city=Kraków

?city=Kraków,Warszawa

province

String
Array

Searches for shipments with given province.

Searches for shipments with given provinces.

?province=Małopolska

?province=Małopolska,Śląsk

virtual

Integer
Array

Searches for shipments with given virtual value.

Searches for shipments with given virtual values.

?virtual=0
?virtual=1,6

updated_from

Date

Searches for points updated after the given date

If updated_to  has not been given the date cannot be earlier than 3 days before the current date

?updated_from=2018-04-24

updated_to

Date

Searches for points updated before the given date

Requires providing updated_from.

?updated_to=2018-04-26

supported_locker_temperatures

Integer

Searches for temperature controlled points.

?supported_locker_temperatures=20

relative_point 

String

Searches for points closest to the given location

?relative_point=52.123,19.321

relative_post_code 

String

Searches for points closest to the given post code

?relative_post_code=11-111

max_distance 

Double

Searches for points in distance up to the given value from relative_point or relative_post_code 

Parameter usage requires sorting by distance.

Default value: 10000 (10km)

Maximum value 50000 (50km)

?relative_point=52.123,19.321&max_distance=10000

limit 

Integer

Point limiting parameter when using relative_point  or relative_post_code 

?limit=10

name 

Sort by point name

?sort_by=name

distance_to_relative_point

Sort by relative distance (relative_point or relative_post_code)

?sort_by=distance_to_relative_point

status

Sort by status

?sort_by=status

asc

Sorts in ascending order

?sort_order=asc&sort_by=status

desc

Sorts in descending order

?sort_order=desc&sort_by=status

page

Defines the page for which the results should be returnet

?page=2

per_page

Defines the amount of points returned per page

Default: 25
Maximum: 500

?per_page=100

fields

Defines the point attributes that should be returned

?fields=name,type