RNL API Documentation

BETA

Authentication

In order to connect to the API, you will need to be in posession of an API key for your company. If you do not have a key yet, you can request one here.
The API uses Basic Authentication for verifying your requests. Encode a combination of your keys, with a colon (:) inbetween, using base64 encode. Place this encoded string in the authorization header of your request. If you provide the wrong (encoded string of) credentials, or you do not have access to a certain endpoint, you will receive a 404 Unauthorized error. Please check what you can do when this happens.

Base URL

All calls to the API can be made using the base URL:

Information

Via this endpoint you are able to request certain information about the API, like the current status and version.

Get all products

Via this endpoint you are able to retrieve a list of all the products that are currently in our inventory. Below you will find all the data that is provided for each product.

Please note that it can take 30-60 seconds for the system to give a response back. It is therefore recommended that you use this endpoint at a certain interval (ex: every 15/30/60 minutes).

Create new order

Via this endpoint you are able to create a new order in our webshop. This endpoint is particularly useful for the automation of dropship orders. To create an order, you need to send the shipping information and a list of products along with your request. Below you will find the required information and a JSON example.

Please provide only the shipping information. The billing information will automatically be retrieved from your RNL account, so you do not have to send them along. The country value needs to be an ISO 3166-1 alpha-2 value. All products in your order need to be listed as arrays under the order_line value.

{
        "first_name": "John",
        "last_name": "Callister",
        "company": "Callister Cooperation",
        "address_1": "612 Halwick Road",
        "address_2": "",
        "city": "London",
        "postcode": "PL6 5RG",
        "country": "GB",
        "order_line": [
            {
                "product_id": 7407,
                "quantity": 5
            },
            {
                "product_id": 14290,
                "quantity": 2
            }
        ]
    }

When the order is created succesfully, you will receive a response with some information. Below you will find an example.

{
    "order_id": 14322,
    "status": "processing",
    "currency": "EUR",
    "total_amount": "436,45",
    "include_tax": false
}

401: Unauthorized

If you encounter this error, it means that either you have used the wrong credentials or you do not have access to use the specific endpoint. Please check if both keys that you have provided are identical to the one's you have been provided with by us. Also check if you are authorized to use the specific endpoint (i.e. using a POST endpoint whilst only been granted permission to use GET endpoints). If all of this is correct and the error persists, please contact our Customer Service.

400: Bad Request

If you encounter this error, it means there is something wrong with the provided data. Please check if you have sent all the required data and if the syntax you have used matches with the required syntax.

410: Gone

If you encounter this error, it means that the endpoint you are trying to reach is no longer available. Please check the endpoints in this documentation for an alternative.

500: Internal Server Error

If you encounter this error, it means that an (unidentified) error has occurred on our side. Please try again at a later moment. If the issue persists, please contact our Customer Service.

503: Service Unavailable

If you encounter this error, it means that the current endpoint is temporarily unavailable or the API is temporarily down for maintenance. Please try again in a few hours. If you still encounter the error 24 hours after initial encounterment, please contact our Customer Service.