1. Requests

1.A Base URL

BaseURL: https://api.myparcel.nl

1.B User-Agent

To give us insight that you use the API documentation, you should always send a User-Agent in your header. If you do not use a known CMS, use the following header: User-Agent: CustomApiCall/2

If you are using a known CMS then you should use the name of the CMS followed by its version number (User-Agent: <product>/<product-version>). Here's an example if your CMS is WordPress: User-Agent: WordPress/4.8.1.

1.C HTTP methods

The API is REST(ful) and uses JSON as its primary data exchange format. Communication with the API goes through HTTPS thereby insuring data confidentiality and integrity. Here is a list of all supported HTTP methods

1.C.1 GET

GET method is used for retrieving data and is idempotent. Data can be returned in JSON, PDF, CSV, XML or other formats.

1.C.2 POST

POST is used to create new objects or send data to MyParcel.

1.C.3 DELETE

DELETE is used to delete an existing object (piece of data). This method always returns HTTP 204 No Content unless otherwise specified.

1.C.4 PUT

A PUT request creates a resource or updates an existing resource. The client for specifies the URI for the resource. The request body contains a complete representation of the resource. If a resource with this URI already exists, it is replaced. Otherwise, a new resource is created, if the server supports doing so.

1.C.5 PATCH

A PATCH request performs a partial update to an existing resource. The client specifies the URI for the resource. The request body specifies a set of changes to apply to the resource. This can be more efficient than using

1.D Rate limiting(WIP)

Rate limits may apply to many of our endpoints. You cannot receive data after you have exceeded the limit. The rate limiting will be reached when you make more than xxx requests per minute. The limit automatically resets after x minute(s).

Example: If you make 100 requests within 15 seconds to the same endpoint with an applied rate limit of 100 request per 5 minutes, you will be able to continue 5 minutes later. Hence the applied timeframe of the rate limit (5 minutes) will also be applied for the cooldown period.

MethodEndpointRate limit
POST/webhook_subscriptions30 calls in 5 minutes
GET/webhook_subscriptions150 calls in 5 minutes
DELETE/webhook_subscriptions30 calls in 5 minutes
GET/tracktraces/{ids?}100 calls in 5 minutes
GET/pickup_locations30 calls in 5 minutes
GET/delivery_options30 calls in 5 minutes
Edit this page
Last updated: 
Contributors Richard Perdaan