Versions Compared
Key
- This line was added.
- This line was removed.
- Formatting was changed.
Points resource represents the locations in which the logistics operator's services are available. Points can be self-service machines (Parcel locker, ParcelPoint) or branches, customer service points. Each of the locations offers specific services - the list of these services is returned to the response under the functions attribute.
Panel | ||||||
---|---|---|---|---|---|---|
| ||||||
Production environments: https://api.inpost.pl/v1/points Generating access
Sandbox Environment: Generating access
|
Info |
---|
More information on the available options Display of collection points |
On this page
Table of Contents |
---|
Structure
Point
resource has the following attributes:
Attribute | Type | Description | ||||
---|---|---|---|---|---|---|
| String | Unique point name e.g. KRA007 (Parcel Locker) | ||||
| Array | Table specifying types of points available at the location. Possible types of points:
| ||||
| String | Point status. | ||||
| Object |
| ||||
| String | Location type. | ||||
| String | Additional location description that may make it easier to reach. | ||||
| String | Additional description | ||||
| String | Additional description | ||||
| Integer | Distance from the relative point location. If the relative point has not been specified, takes null value. | ||||
| String | Point opening hours | ||||
| Object |
| ||||
| Object | Detailed point address data
| ||||
| String | Point telephone number | ||||
| String | Additional information about the point | ||||
| Array | Table specifying the functions offered by the point. Possible functions:
| ||||
| Integer | Partner ID 60 - Parcel points Żabka 61 - Parcel lockers Żabkaof 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. | ||||
| Boolean | Is it a NEXT automatic parcel station | ||||
| 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 | ||||
| String | Payment type parameter | ||||
| Integer | Virtual point | ||||
| Array | Other points recommended nearby | ||||
| 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). | ||||
| String | Type of parcel locker | ||||
| String | Description for type of parcel locker |
Point
resource in JSON format:
Code Block | ||
---|---|---|
| ||
{ "href": "https://api-pl-points.easypack24.net/v1/points/KRA02APP", "name": "KRA02APP", "type": [ "parcel_locker" ], "status": "Operating", "location": { "longitude": 19.87325, "latitude": 50.00919 }, "location_type": "Outdoor", "location_date": null, "location_description": "Prywatna posesja wjazd od strony Dobrowolskiego", "location_description_1": null, "location_description_2": null, "distance": null, "opening_hours": "24/7", "address": { "line1": "Dobrowolskiego", "line2": "30-394 Kraków" }, "address_details": { "city": "Kraków", "province": "małopolskie", "post_code": "30-394", "street": "Dobrowolskiego", "building_number": ""null, "flat_number": null }, "phone_number": null, "payment_point_descr": "Płatność internetowa aplikacjąapką InPost Mobile oraz PayByLink", "functions": [ "allegro_courier_collect", "allegro_courier_reverse_return_send", "allegro_courier_send", "allegro_letter_reverse_return_send", "allegro_letter_send", "allegro_parcel_collect", "allegro_parcel_reverse_return_send", "allegro_parcel_send", "parcel", "parcel_collect", "parcel_reverse_return_send", "parcel_send", "standard_courier_reverse_return_send", "standard_courier_send" ], "partner_id": 0, "is_next": false, "payment_available": true, "payment_type": { "0": "Payments are not supported" }, "virtual": "0", "recommended_low_interest_box_machines_list": null,[ "apm_doubledKRA106M":, null, "location_247": true, "KRA20M", "operating_hours_extended": {KRA208M", "customerKRA197M":, null }, "KRA356M" "agency": "IPM5426863" ], "imageapm_urldoubled": "https://static.easypack24.net/points/pl/images/KRA02APP.jpg"null, "easylocation_access_zone247": true, "airoperating_indexhours_levelextended": null,{ "physical_type_mapped": "006" "customer": null }, "physical_type_descriptionagency": "Ważne! Swoją paczkę odbierzesz wygodniej z aplikacją InPost"IPM9988771", "image_url": "https://static.easypack24.net/points/pl/images/KRA02APP.jpg", } |
List of Points
List of Points retrieval, the collection supports pagination, which can be found in API General information.
Code Block |
---|
GET /v1/points |
Example request
Code Block | ||
---|---|---|
| ||
curl -X GET https://api.inpost.pl/v1/points -H 'Content-Type: application/json' |
Response
Code Block | ||
---|---|---|
| ||
{ "href": "https://api-pl-points.easypack24.net/v1/points", "count": 19378, "page": 1, "per_page": 25, "total_pages": 776, "items": [ { "easy_access_zone": true, "air_index_level": "GOOD", "physical_type_mapped": "006", "physical_type_description": "Appkomat InPost – swoją paczkę odbierzesz wygodniej z aplikacją InPost" } |
List of Points
List of Points retrieval, the collection supports pagination, which can be found in API General information.
Code Block |
---|
GET /v1/points |
Example request
Code Block | ||
---|---|---|
| ||
curl -X GET https://api.inpost.pl/v1/points -H 'Content-Type: application/json' |
Response
Code Block | ||
---|---|---|
| ||
{ "href": "https://api-pl-points.easypack24.net/v1/points", "count": 24797, "page": 1, "per_page": 25, "total_pages": 992, "items": [ { "href": "https://api-pl-points.easypack24.net/v1/points/ADA01M", "name": "ADA01M", "type": [ "parcel_locker" ], "status": "Operating", "location": { "longitude": 22.26405, "latitude": 51.73834 }, "location_type": "Outdoor", "location_date": null, "location_description": "Przy sklepie Lewiatan", "location_description_1": null, "location_description_2": null, "distance": null, "opening_hours": "24/7", "address": { "line1": "Kościuszki 27", "line2": "21-412 Adamów" }, "address_details": { "city": "Adamów", "province": "lubelskie", "post_code": "21-412", "street": "Kościuszki", "building_number": "27", "flat_number": null }, "phone_number": null, "payment_point_descr": "Płatność apką InPost oraz PayByLink", "functions": [ "allegro_courier_collect", "allegro_courier_reverse_return_send", "allegro_courier_send", "allegro_letter_reverse_return_send", "allegro_letter_send", "allegro_parcel_collect", "allegro_parcel_reverse_return_send", "allegro_parcel_send", "parcel", "parcel_collect", "href": "https://api-pl-points.easypack24.net/v1/points/ADA01M",parcel_reverse_return_send", "name": "ADA01Mparcel_send", "type": [ "standard_courier_reverse_return_send", "parcelstandard_courier_lockersend" ], "statuspartner_id": "Operating"0, "locationis_next": {false, "payment_available": true, "longitudepayment_type": 22.26405,{ "latitude0": 51.73834"Payments are not supported" }, "location_typevirtual": "Outdoor0", "location_daterecommended_low_interest_box_machines_list": null, "locationapm_descriptiondoubled": "Przy sklepie Lewiatan"null, "location_description_1247": nulltrue, "locationoperating_descriptionhours_2extended": null,{ "distancecustomer": null, "opening_hours": "24/7"}, "addressagency": {"IPM4633224", "line1"image_url": "Kościuszki 27", https://static.easypack24.net/points/pl/images/ADA01M.jpg", "line2easy_access_zone": "21-412 Adamów" }true, "addressair_index_detailslevel": { null, "city"physical_type_mapped": "Adamów004", "province"physical_type_description": "lubelskie",null }, {...}, "post_code": "21-412" {...}, ] } |
Point details
Get point details.
Code Block | ||
---|---|---|
| ||
GET /v1/points?name=point_name |
Example request
Code Block | ||
---|---|---|
| ||
curl -X GET https://api.inpost.pl/v1/points?name=KRA02APP -H 'Content-Type: application/json' |
Response
Code Block | ||
---|---|---|
| ||
{ "streethref": "Kościuszkihttps://api-pl-points.easypack24.net/v1/points", "count": 1, "page": 1, "buildingper_numberpage": "27"25, "total_pages": 1, "flat_number"items": null[ { }, "phone_number": null"href": "https://api-pl-points.easypack24.net/v1/points/KRA02APP", "payment_point_descrname": "Płatność internetowa aplikacją InPost Mobile oraz PayByLinkKRA02APP", "functionstype": [ "allegroparcel_courier_collectlocker", "allegro_courier_reverse_return_send"], "status": "allegro_courier_sendOperating", "allegro_letter_reverse_return_send","location": { "allegro_letter_send"longitude": 19.87325, "allegro_parcel_collect", latitude": 50.00919 "allegro_parcel_reverse_return_send"}, "allegro_parcel_send", "location_type": "Outdoor", "parcel", location_date": null, "parcel_collect", location_description": "Prywatna posesja wjazd od strony Dobrowolskiego", "parcellocation_reversedescription_return_send", 1": null, "parcel_send""location_description_2": null, "distance": null, "standard_courier_reverse_return_send", "opening_hours": "24/7", "standard_courier_send" "address": { ], "partner_idline1": 0"Dobrowolskiego", "is_next "line2": false, "30-394 Kraków" "payment_available": true }, "paymentaddress_typedetails": { "0city": "Payments are not supported" Kraków", }, "virtualprovince": "0małopolskie", "recommended_low_interest_box_machines_listpost_code": null"30-394", "apm_doubled": null, "street": "Dobrowolskiego", "locationbuilding_247number": truenull, "operatingflat_hours_extendednumber": {null }, "customer": null }"phone_number": null, "agencypayment_point_descr": "IPM4633224Płatność apką InPost oraz PayByLink", "image_urlfunctions": "https://static.easypack24.net/points/pl/images/ADA01M.jpg", [ "easyallegro_accesscourier_zone": true,collect", "air_index_level": null,allegro_courier_reverse_return_send", "physicalallegro_typecourier_mapped": "004",send", "physical_type_description": null allegro_letter_reverse_return_send", }, {...}, {...}, ] } |
Point details
Get point details.
Code Block | ||
---|---|---|
| ||
GET /v1/points/:point_name |
Example request
Code Block | ||
---|---|---|
| ||
curl -X GET https://api.inpost.pl/v1/points/KRA012 -H 'Content-Type: application/json' |
Response
Code Block | ||
---|---|---|
| ||
{ "allegro_letter_send", "href": "https://api-pl-points.easypack24.net/v1/points/KRA012 "allegro_parcel_collect", "name": "KRA012 "allegro_parcel_reverse_return_send", "type": [ "allegro_parcel_lockersend", ], "status": "Operating", "location": { parcel", "longitude": 20.00399, "latitudeparcel_collect":, 50.08913 }, "location_type": "Outdoor", "location_date": null,parcel_reverse_return_send", "location_description": "Stacja paliw Lotos", "locationparcel_description_1": nullsend", "location_description_2": "Lotos", "distance": null, "opening_hours": "24/7",standard_courier_reverse_return_send", "address": { "line1": "Os. Kombatantów 20",standard_courier_send" ], "line2": "31-630 Kraków" }, "addresspartner_detailsid": 0, { "cityis_next": "Kraków"false, "province "payment_available": "małopolskie", true, "postpayment_codetype": "31-630",{ "street": "Os. Kombatantów", "building_number0": "20", Payments are not supported" "flat_number": null }, "phone_number": null, "payment_point_descrvirtual": "0"Płatność, w Paczkomacie kartą płatniczą lub BLIKIEM oraz internetowo aplikacją InPost Mobile i PayByLink", "functionsrecommended_low_interest_box_machines_list": [ "allegro_courier_collect "KRA106M", "allegro_courier_reverse_return_send", "allegro_courier_sendKRA20M", "allegro_letter_send", "allegro_parcel_collectKRA208M", "allegro_parcel_reverse_return_send", "allegro_parcel_sendKRA197M", "parcel", "parcel_collectKRA356M", "parcel_reverse_return_send", ], "parcel_send", "standard_courier_reverse_return_send"apm_doubled": null, "standardlocation_courier_send247": true, ], "partneroperating_hours_idextended": 0,{ "is_next": false, "payment_available": true, "payment_typecustomer": {null "2": "Payment by card}, in the machine" }, "virtualagency": "0IPM9988771", "recommended_low_interest_box_machines_list": [ "image_url": "KRA175M"https://static.easypack24.net/points/pl/images/KRA02APP.jpg", "KRA274M", "easy_access_zone": true, "KRA227Mair_index_level": "GOOD", "KRA273M", "physical_type_mapped": "006", "KRA144M" ], "apmphysical_type_doubleddescription": null,"Appkomat InPost – swoją "location_247": true, "operating_hours_extended": {paczkę odbierzesz wygodniej z aplikacją InPost" } "customer": null ], }, "meta": { "agency": "IPM4956660", "image_urlhref": "https://staticapi-pl-points.easypack24.net/points/pl/images/KRA012.jpgv1/points", "easy_access_zone "count": false1, "air_index_level "page": null1, "physicalper_type_mappedpage": "001"25, "total_pages": 1 "physical_type_description": null } } |
Search criteria
Parameter | Type | Description | Example |
---|---|---|---|
| String | Searches for shipments with given name. Searches for shipments with given names. |
|
| String | Searches for shipments with given type. Searches for shipments with given types. |
|
| String | Searches for shipments with given function. Searches for shipments with given functions. |
|
| Integer | Searches for shipments with given partner ID. Searches for shipments with given partner IDs. |
|
| Boolean | Searches for NEXT parcel locker points |
|
| Boolean | Searches by payment availability at the point |
|
| String | Searches for shipments with given post code. Searches for shipments with given post codes. |
|
| String | Searches for shipments with given city. Searches for shipments with given cities. |
|
| String | Searches for shipments with given province. Searches for shipments with given provinces. |
|
| Integer | Searches for shipments with given virtual value. Searches for shipments with given virtual values. |
|
| Date | Searches for points updated after the given date If |
|
| Date | Searches for points updated before the given date Requires providing |
|
Search by location
| String | Searches for points closest to the given location |
|
| String | Searches for points closest to the given post code |
|
| Double | Searches for points in distance up to the given value from Parameter usage requires sorting by distance. Default value: 10000 (10km) Maximum value 50000 (50km) |
|
| Integer | Point limiting parameter when using |
|
Result sorting
| Sort by point name |
|
| Sort by relative distance ( |
|
| Sort by status |
|
Sort ordering can be set using sort_order
attribute. By default the results are sorted in an ascending order using the name
field.
| Sorts in ascending order |
|
| Sorts in descending order |
|
Pagination
| Defines the page for which the results should be returnet |
|
| Defines the amount of points returned per page Default: 25 |
|
Filtering of returned fields
| Defines the point attributes that should be returned |
|