Versions Compared

Old Version 2

changes.mady.by.user Michał Machowski

Saved on

compared with

New Version Current

changes.mady.by.user Michał Machowski

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Collecting the list of points.

Changes since version 1.7.0:

  1. Entering hard validation for all parameters of Integer, Double, List <Integer> type: in case of incorrect format or incorrect value of API parameter returns error, so far the parameter was ignored.
  2. Removing Polish translations - in the request for a possible function or possible payment method.

Points resource represents the locations in which logistic operatorsthe logistics operator's services are available. Points can be self-service machines (Paczkomat Automatic Parcel Stationlocker, LaundromatParcelPoint) or branches, customer service points. Each of the locations offers specific services - the list of these services is returned in to the response under the functions attribute
Resource location.

Panel
panelIconIdatlassian-info
panelIcon:info:
bgColor#E3FCEF


New environments with authorization

Production environments:

https://api

-shipx-pl

.

easypack24

inpost.

net

pl/v1/points

Panel
bgColor#f0f0f0
titleBGColor#f0f0f0
titleOn this page

Table of Contents
minLevel2
 

Structure

Points resource elements have the following attributes:

AttributeType

Description

hrefString

The URI address to the resource of the particular point

nameString

Point ID. This is its unique name, e.g. KRA007 (for a Parcel Station)

typeArray

Table specifying the kinds of points that are in the given location. Possible types of points:

• parcel_locker - Physical automatic parcel machine and shipment handling points where a parcel machine shipment can be sent.          

• pop - Shipment handling points.     

• parcel_locker_only - Only physical automatic parcel machine.      

• parcel_locker_superpop - Shipment handling points which a parcel machine shipment can be sent to.        

status
String

Point status.

locationObject

Location object containing information on the geographic location: latitude and longitude.

Sample Location object in the JSON format: 

Code Block
"latitude": 50.03988,
"longitude": 19.92485
location_type
String

Location type.

location_descriptionString

Additional information about point location that may make it easier to reach it.

location_description_1
String

Additional description.

location_description_2
String

Additional description.

distance
Integer

Distrance from a relative point stated in the search. If the relative point has not been provided, then it takes null value.

opening_hours
String

Point opening hours

addressObject

Address object containing address information about the point such as: street, postal code, city. Sample Address object in the JSON format:

Code Block
"line1": "Kapelanka 14",
"line2": null
address_details
Object

Detailed point address data

Code Block
"city": "Bartoszyce",
"province": "Warmińsko-Mazurskie",
"post_code": "11-200",
"street": null,
"building_number": null,
"flat_number": null
phone_number
String

Point telephone number

payment_point_descr
String

Additional information about the point

functionsArray

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

parcel=Send and collect standard parcel parcel_send=Standard parcel send parcel_collect=Standard parcel collect parcel_reverse_return_send=Standard parcel reverse return to sender standard_letter_collect=Standard letter collect standard_letter_send=Standard letter send allegro_parcel_collect=Allegro parcel collect allegro_parcel_send=Allegro parcel send allegro_parcel_reverse_return_send=Allegro parcel return to sender allegro_letter_collect=Allegro letter collect allegro_letter_send=Allegro letter send

Generating access

  1. Go to the Parcel Manager website https://manager.paczkomaty.pl

  2. In the login window, enter your login and click: Login

  3. After logging in go to My Account tab

  4. In the Data tab check if all the company data is correctly filled in
    Remember, in order to generate access to API, both your company address and invoice data have to be filled in.

  5. After verification go to the new tab API

  6. To generate a new Point Access, expand the ShipX API tab and click Generate

  7. If you already have a token generated make sure to use a token from the list (Lista tokenów do API InPost (API ShipX oraz API Points)) for authentication. If you do not have such a list you need to generate a new token.

Sandbox Environment:
https://sandbox-api-gateway-pl.easypack24.net/v1/points

Generating access

  1. Go to the Parcel Manager website https://sandbox-manager.paczkomaty.pl/

  2. In the login window, enter your login and click: Login

  3. After logging in go to My Account tab

  4. In the Data tab check if all the company data is correctly filled in
    Remember, in order to generate access to API, both your company address and invoice data have to be filled in.

  5. After verification go to the new tab API

  6. To generate a new Point Access, expand the ShipX API tab and click Generate

  7. If you already have a token generated make sure to use a token from the list (Lista tokenów do API InPost (API ShipX oraz API Points)) for authentication. If you do not have such a list you need to generate a new token.

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

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:

Code Block
"latitude": 50.03988,
"longitude": 19.92485


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:

Code Block
"line1": "Kapelanka 14",
"line2": null


Code Block
address_details

Object

Detailed point address data

Code Block
"city": "Bartoszyce",
"province": "Warmińsko-Mazurskie",
"post_code": "11-200",
"street": null,
"building_number": null,
"flat_number": null


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:

Code Block
parcel=Send and collect standard parcel 
parcel_send=Standard parcel send 
parcel_collect=Standard parcel collect 
parcel_reverse_return_send=Standard parcel reverse return to sender 
standard_letter_collect=Standard letter collect 
standard_letter_send=Standard letter send 
allegro_parcel_collect=Allegro parcel collect 
allegro_parcel_send=Allegro parcel send 
allegro_parcel_reverse_return_send=Allegro parcel return to sender 
allegro_letter_collect=Allegro letter collect 
allegro_letter_send=Allegro letter send 
allegro_letter_reverse_return_send=Allegro letter return to sender 
allegro_courier_collect=Allegro courier parcel collect 
allegro_courier_send=Allegro courier parcel send 
allegro_courier_reverse_return_send=Allegro courier parcel return to sender 
standard_courier_collect=Courier parcel collect 
standard_courier_send=Courier parcel send 
standard_courier_reverse_return_send=Courier parcel return to sender 
air_on_airport=Send and collect baggage from machine on airport 
air_outside_airport=Send and collect baggage from machine outside of airport 
cool_parcel_collect=Reservation collect from cooling machine 
laundry=Send and collect laundry 
avizo=Avizo collect


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

is

payment_

next

available 

Boolean

Availability of

payments in the

payment at a given point

.

There is a possibility of payment_available = true

together

with payment_type = 0,

this

it means

that

the payment is available

.

payment_

availableBoolean

Dostępność płatności w danym punkcie.

Istnieje możliwość wystąpienia payment_available=true razem z payment_type=0, oznacza to, że płatność jest dostępna.

payment_type

type 

String

virtual

Payment type parameter

virtual 

Integer

Point virtuality

Virtual point

recommended_low_interest_box_machines_list 

Array

Recommended other

Other points recommended nearby

Sample Point resource in the JSON format:

Code Block{

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

Point resource in JSON format:

Code Block
languagejson
{
            "href": "
http
https://api-pl-points.easypack24.net/v1/points/
KRA011
KRA02APP",
            "name": "
KRA011
KRA02APP",
            "type": [
                "parcel_locker"
            ],
            "status": "Operating",
            "location": {
"latitude":50.09103,
        "longitude": 19.
9299
87325,
},
"location_type":null,
     "
location_description":"Stacja paliw Lukoil",
latitude": 50.00919
            },
            "location_
description_1
type": "Outdoor",
"location_description_2":"LUKOIL",
"distance":null,
    "
opening
location_
hours
date": null,
"address":{
         "
line1
location_description": "
Opolska 9
Prywatna posesja wjazd od strony Dobrowolskiego",
"line2":"31-274 Kraków"
      "location_description_1": null,
},
    "
address
location_description_
details
2":
{
 null,
            "
city
distance":
"Kraków"
 null,
"province":"małopolskie",
       "
post
opening_
code
hours":
"31-274
 "24/7",
"street":"Opolska",
      
"
building_number
address":
"9",
 {
"flat_number":null
},
"phone_number":null,
    "
payment_point_descr
line1": "
Płatność internetowa PayByLink
Dobrowolskiego",
"functions":[
"allegro_courier_collect",
    "line2":
"allegro_courier_reverse_return_send",
"30-394 Kraków"
"allegro_courier_send",
"allegro_letter_send"
},
"allegro_parcel_collect", 
      "
allegro_parcel_reverse_return_send",
address_details": {
"allegro_parcel_send",
      "city": "
parcel
Kraków",
"parcel_collect",
      "province": "
parcel_reverse_return_send
małopolskie",
"parcel_send",
          "
standard_courier_reverse_return_send",
post_code": "30-394",
"standard_courier_send"
],
    "
partner_id
street":
0,
"is_next":false
"Dobrowolskiego",
"payment_available":true,
"payment_type":{
         "
0
building_number":
"Brak
 null,
obsługi
płatności"
},
"virtual":"0",
       "flat_number": null
            },
            "phone_number": null,
            "
recommended
payment_
low_interest_box_machines_list":null }

Authentication

Access to the resource does not require authentication.. 

List of points

Pobieranie listy punktów.

Code Block
GET /v1/points

In the response the server will return a collection with the list of points.
The collection supports paging that is described on page API General.

Sample request

Code Block
GET https://api-shipx-pl.easypack24.net/v1/points HTTP/1.1
Host: api-shipx-pl.easypack24.net

Response

HTTP/1.1 200 OK Content-Type: application/json { "href":"https://api-pl-points.easypack24.net/v1/points", "count":5363, "page":1, "per_page":25, "total_pages":215, "items":[ {
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",
                "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": [
                "KRA106M",
                "KRA20M",
                "KRA208M",
                "KRA197M",
                "KRA356M"
            ],
            "apm_doubled": null,
            "location_247": true,
            "operating_hours_extended": {
                "customer": null
            },
            "agency": "IPM9988771",
            "image_url": "https://static.easypack24.net/points/pl/images/KRA02APP.jpg",
            "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
languagejson
curl -X GET https://api.inpost.pl/v1/points -H 'Content-Type: application/json'

Response

Code Block
languagejson
{
    "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",
                "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_doubled": null,
"href":"http://api-pl-points.easypack24.net/v1/points/ADA01N"
"location_247": true,
"name":"ADA01N",
   "operating_hours_extended": {
                "
type
customer":
[
 null
            },
"parcel_locker"
],
"agency": "IPM4633224",
            "
status
image_url":
"Operating",
 "https://static.easypack24.net/points/pl/images/ADA01M.jpg",
            "
location
easy_access_zone":
{
 true,
            
"
latitude
air_index_level":
51.74455
 null,
            "
longitude
physical_type_mapped":
22.25847 
 "004",
},
"location
"physical_type_description": null
,
"location_description":"Przy sklepie Groszek"
},
"location_description_1":null
{...},
    {...},
  ]
"location_description_2":"Groszek", 
}

Point details

Get point details.

Code Block
languagejson
GET /v1/points?name=point_name

Example request

Code Block
languagejson
curl -X GET https://api.inpost.pl/v1/points?name=KRA02APP -H 'Content-Type: application/json'

Response

Code Block
languagejson
{
    
"
distance
href":
null, 
 "
opening_hours":"24/7", 
https://api-pl-points.easypack24.net/v1/points",
    
"
address
count":
{
 1,
    "page": 1,
"line1
"per_page":
"Kleeberga
5B"
25,
    
"total_pages": 1,
    
"
line2
items":
"21-412 Adamów"
 [
        {
},
          "
address_details
href":
{ 
 "https://api-pl-points.easypack24.net/v1/points/KRA02APP",
            
"
city
name": "
Adamów
KRA02APP",
            "
province
type":
"lubelskie",
 [
"post_code":"21-412",
"parcel_locker"
"street":"Kleeberga"
],
            "
building_number
status": "
5B
Operating",
            "
flat_number
location":
null
 
{
},
         
"
phone_number
longitude":
null, 
 19.87325,
"payment_point_descr":"Płatność
internetowa
PayByLink.
Dostępność
24/7",
          "
functions
latitude":
[
 
50.00919
"allegro_courier_collect"
 },
            "
allegro_courier_reverse_return_send
location_type": "Outdoor",
            "
allegro
location_
courier_send"
date": null,
            "
allegro_letter_reverse_return_send
location_description": "Prywatna posesja wjazd od strony Dobrowolskiego",
            "
allegro
location_
letter
description_
send
1": null,
            "
allegro
location_
parcel
description_
collect
2": null,
            "
allegro_parcel_reverse_return_send"
distance": null,
            "
allegro_parcel_send
opening_hours": "24/7",
            "
parcel",
address": {
                "line1": "
parcel_collect
Dobrowolskiego",
"parcel_reverse_return_send",
   "line2": "30-394 Kraków"
"parcel_send"
},
            "
standard_courier_reverse_return_send",
address_details": {
                "
standard_courier_send
city": "Kraków",
],
        "province": 
"
partner_id
małopolskie"
:0,
,
                "
is
post_
next
code":
true
 "30-394",
"payment_available":true,
       "street": "Dobrowolskiego",
"payment_type":{
               "
0
building_number":
"Brak obsługi płatności" 
 null,
},
          "
virtual
flat_number":
"0",
 null
"recommended_low_interest_box_machines_list":null
},
},
{
"phone_number": null,
            "
href
payment_point_descr":
"http://api-pl-points.easypack24.net/v1/points/ALK01A", 
 "Płatność apką InPost oraz PayByLink",
"name":"ALK01A",
         
"
type
functions": [
                "
parcel
allegro_courier_
locker
collect",
], 
       "
status":"Operating"
allegro_courier_reverse_return_send",
"location":{
       
"allegro_courier_send",
"latitude":52.8684,
             "
longitude":18.7031 
allegro_letter_reverse_return_send",
},
          "
location
allegro_letter_
type
send"
:null
,
"location_description":"Przy
biurze
usług ubezpieczeniowych", 
     "
location
allegro_
description
parcel_
1
collect"
:""
,
"location_description_2":"",
"distance":null, 
"allegro_parcel_reverse_return_send",
"opening_hours":"24/7",
           "
address":{
allegro_parcel_send",
                "
line1":"Słowackiego 131"
parcel",
"line2":"87-700 Aleksandrów
Kujawski"
   "parcel_collect",
},
          "
address_details":{
parcel_reverse_return_send",
                "
city":"Aleksandrów Kujawski",
parcel_send",
                "
province":"kujawsko-pomorskie
standard_courier_reverse_return_send",
"post_code":"87-700",
   "standard_courier_send"
"street":"Słowackiego"
],
            "
building
partner_
number
id":
"131"
 0,
            "
flat
is_
number
next":
null 
 false,
],
[...]
}

Point details

Collecting point details.

Code Block
GET /v1/points/:nazwa_punktu

In the response the server will return point details.

Sample request

Code Block
GET https://api-shipx-pl.easypack24.net/v1/points/AAB001 HTTP/1.1
Host: api-shipx-pl.easypack24.net

Response

Code BlockHTTP/1.1 200 OK Content-Type: application/json {
   "payment_available": true,
            "payment_type": {
                "
href
0":
"http://api-pl-points.easypack24.net/v1/points/ADA01N",
 "Payments are not supported"
"name":"ADA01N",
"type":[
    },
"parcel_locker"
],
    "
status
virtual": "
Operating
0",
"location":{
         "
latitude":51.74455,
recommended_low_interest_box_machines_list": [
"longitude":22.25847
},
    "
location_type
KRA106M"
:null
,
"location_description":"Przy sklepie Groszek",
             "
location_description_1":null,
KRA20M",
"location_description_2":"Groszek",
        "
distance
KRA208M"
:null
,
"opening_hours":"24/7",
"address":{
         "
line1
KRA197M"
:"Kleeberga 5B",
,
"line2":"21-412
Adamów"
},
    "
address_details":{
KRA356M"
"city":"Adamów",
],
            "
province
apm_doubled":
"lubelskie",
 null,
            "
post
location_
code
247":
"21-412"
 true,
"street":"Kleeberga", 
      "
building
operating_hours_
number
extended":
"5B",
 {
"flat_number":null
},
    "
phone_number
customer": null
,
"payment_point_descr":"Płatność
internetowa
PayByLink.
Dostępność
24/7",
"functions":[
  },
"allegro_courier_collect",
      "agency": "
allegro_courier_reverse_return_send
IPM9988771",
"allegro_courier_send",
"allegro_letter_reverse_return_send", 
"image_url": "https://static.easypack24.net/points/pl/images/KRA02APP.jpg",
"allegro_letter_send",
       "
allegro
easy_
parcel
access_
collect
zone": true,
"allegro_parcel_reverse_return_send", 
      "
allegro
air_
parcel_send
index_level": "GOOD",
"parcel",
      "physical_type_mapped": "
parcel_collect
006",
"parcel_reverse_return_send",
       "
parcel_send", "standard_courier_reverse_return_send",
physical_type_description": "Appkomat InPost – swoją paczkę odbierzesz wygodniej z aplikacją InPost"
"standard_courier_send"
}
    ],
    "
partner_id
meta":
0,
 {
"is_next":true,
"href": "https://api-pl-points.easypack24.net/v1/points",
"payment_available":true,
    "
payment_type
count":
{
 1,
        "
0
page":
"Brak
obsługi
1,
płatności"
},
    "
virtual
per_page":
"0",
 25,
        "
recommended_low_interest_box_machines_list":null
total_pages": 1
    }
}

Search criteria

Parameter

Type

Description

Example

name

String
Array

Point

Searches for shipments with

the name specified in the search

given name.

Searches for shipments with given names.

?name=KRA010
?name=Kra010,ADA01N

type

String
Array

List of types of points, comma separated, which are to be returned in the response

Searches for shipments with given type.

Searches for shipments with given types.

?type=parcel_locker
?type=parcel_locker,pop

functions

String
Array

Searches for

points

shipments with

the stated

given function.

Searches for

points

shipments with

all the listed

given functions.

?functions=parcel
?functions=

parcel

parcel,parcel_send

partner_id

Integer
Array

Searches for

points

shipments with

the stated

given partner

_id

ID.

Searches for

points

shipments with

the stated

given partner

_id

IDs.

?partner_id=1
?partner_id=1,2

is_next

Boolean

Searches for NEXT parcel locker points

that are NEXT

?is_next=true

payment_available 

Boolean

Filtering the list of points on the availability of payments for

Searches by payment availability at the point

.

?payment_available=true

post_code

String
Array

Searches for

points which have the stated postal

shipments with given post code.

Searches for

points which have the stated postal

shipments with given post codes.

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

city

String
Array

Searches for

points which have the stated

shipments with given city.

Searches for

points which have the stated city

shipments with given cities.

?city=Kraków

?city=Kraków,Warszawa

province

String
Array

Searches for

points which have the stated voivodeship. Searches for points which have the stated voivodeships

shipments with given province.

Searches for shipments with given provinces.

?province=Małopolska

?province=Małopolska,Śląsk

virtual

Integer
Array

Searches for

points with the stated virtuality.

shipments with given virtual value.

Searches for

points with the stated virtualities

shipments with given virtual values.

?virtual=0
?virtual=1,6

updated_from

Date

Search

Searches for points

by

updated after the

date when the point update was made. The parameter should be provided together with updated_to.

given date

If

the

updated_to

parameter

  has not been

specified,

given the date cannot be earlier than 3 days

back counting from

before the current date

.

?updated_from=2018-04-24

updated_to

Date

Search

Searches for points

by

updated before the

date when the point update was made. The parameter should be provided together with updated_from.If the updated_from parameter has not been specified, the date cannot be later than 3 days back counting from the updated_from parameter

given date

Requires providing updated_from.

?updated_to=2018-04-26

Search by location

relative_point 

String

Searches for points

located as close as possible

closest to the

stated geographical coordinates.

given location

?relative_point=52.123,19.321

relative_post_code 

String

Searches for points

located as close as possible

closest to the

stated postal

given post code

.

?relative_post_code=11-111

max_distance 

Double

Specifies distance in meters from the point stated in .

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

.Using the parameter forces

 

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

Limit of returned points

Point limiting parameter when using

parameters in

relative_point  or relative_post_code

.

 

?limit=10

Sorting results

Result sorting

name 

Sorting

Sort by point name

.

?sort_by=name

distance_to_relative_point

Sorting

Sort by relative distance

from the relative point

(relative_point or relative_post_code)

?sort_by=distance_to_relative_point

status

Sorting parameter:

Sort by status

?sort_by=status

Sorting can be done in both directions, using the sort_order

Sort ordering can be set using sort_order  attribute. By default the results are sorted in an ascending order using the name field.

asc

Sorts

points

in ascending order

?sort_order=asc&sort_by=status

desc

Sorts

points

in descending order

?sort_order=desc&sort_by=status

By default, the results are sorted ascending (asc) by point name (name).

Paging

pageSpecifies the results page, which should be returned.

Pagination

page

Defines the page for which the results should be returnet

?page=2

per_page

Specifies

Defines the

number of results displayed on the page.

amount of points returned per page

Default

value

: 25
Maximum

value

: 500

?per_page=100

Filtering

displayed

of returned fields

fields

Specifies

Defines the

list of

point attributes

to be displayed on page.

that should be returned

?fields=name,type