RouteLogic Documentation

Introduction

Base URL: https://api.routelogic.io

This documentation aims to provide all the information you need to work with the RouteLogic API.

As you scroll, you'll see code examples for working with the API in different programming languages in the dark area to the right (or as part of the content on mobile). You can switch the language used with the tabs at the top right (or from the nav menu at the top left on mobile).

Authenticating requests

To authenticate requests, include an Authorization header with the value "Bearer {YOUR_API_KEY}".

All authenticated endpoints are marked with a requires authentication badge in the documentation below.

You can retrieve your token by visiting your account click your name and go to synchronisation.

V2

Tasks

Tasks are the deliveries or pickups that need to be done by your drivers.

GET Tasks

GET

https://api.routelogic.io

/api/v2/tasks

requires authentication

Get paginated collection of tasks from your company

RateLimit (1/min)
If you like to receive tasks quicker use webhooks read more here

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

filters

object

filters.search

string

Search for specific tasks. (customer name, city, street, house number, postal, external identifier and external reference). Must not be greater than 128 characters.

Example:

Amsterdam

filters.from_date

string

Find tasks on this date and later. Combine with to_date to select a specific day or a range. Must be a valid date in the format Y-m-d.

Example:

2025-07-30

filters.to_date

string

Find tasks on this date and earlier. Combine with from_date to select a specific day or a range. Must be a valid date in the format Y-m-d.

Example:

2025-07-30

filters.types

string[]

Filter on specific task types.

Must be one of:

delivery
pickup
recurring

Example:

["pickup"]

filters.statuses

string[]

Filter on tasks with a specific status.

Must be one of:

planned
not_planned
delivered
delivery_failed

Example:

["not_planned"]

filters.deleted

string

Include or only return deleted items in the response. Leave empty to not show deleted items at all.

Must be one of:

include
only

Example:

only

filters.limit

integer

Amount of items on each page. 24 by default. Must not be greater than 100. Must be at least 1.

Example:

filters.page

integer

Must be at least 1.

Example:

Response Fields

data

object[]

Collection of tasks

object

uuid

string

The uuid of this task

type

string

enum(delivery|pickup|shipment) The type of this task

external_identifier

string

Unique identifier like order number

external_reference

string|null

Reference for api connections

note

string|null

Internal note for the driver / note from customer on order for the driver

pending_payment_amount

number

Amount the customer needs to pay on delivery

external_link

string|null

Link visible on the track and trace page like a bill

track_and_trace_link

string

Link to the track and trace page

delivery_from_date

string|null

The earliest date the task is allowed to be completed

delivery_date

string

The date the task is supposed to be completed

start_time

string|null

The time window start time. Timezone: Europe/Amsterdam

end_time

string|null

The time window end time. Timezone: Europe/Amsterdam

delivery_duration_minutes

integer

The time needed on location to complete the task

return_required

boolean

Specifies if the task should also have a corresponding 'pickup' task

signature_required

boolean

If the customer is required to place a signature for this task

used_capacity_1

integer

The amount of capacity this task takes

used_capacity_2

integer

The amount of capacity this task takes

used_capacity_3

integer

The amount of capacity this task takes

created_at

string

Date and time when this task was created

updated_at

string

Date and time when this task was updated

tags[]

string[]

The identifier of a tag. Tasks with a tag will only be planned in to vehicles with the same tag.

return_task_uuid

string|null

The uuid of a related return task if available

notification_template_uuid

string|null

The uuid of the related notification template, null if using the default template

recurring

object|null

Recurring information

address

object

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

customer

object

Customer information

next_visit

object|null

Information of the next visit. Keep in mind that this is the next visit if u make use of recurring tasks then tasks can have more than 1 visit. This might not be the visit information u are expecting then. Please use the schedule endpoint to relate to the right visit.

uuid

string

The uuid of this visit

type

string

enum(start|end|task|break|charge) The type of visit

order_index

integer

Index on which order the visits should be visited

delivery_time

string

The time which this visit should be completed

task_uuid

string|null

The related task to this visit

address

object|null

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country[]

object

Country information

country

object

scanned_codes

object[]|null

Collection of ScannedCodes

returnable_packaging

object[]|null

Collection of Returnable packaging

data

object

files

object[]|null

Collection of Files

signature

string

The key of this file. Used for retrieving the file through the files endpoint.

shipment_steps

object|null

The shipment steps when a task has a shipment type. Shipments always consist of exactly 2 steps: pickup and delivery. The pickup step must be executed before the delivery step.

pickup

object

The pickup step of the shipment.

delivery_duration_minutes

integer

The time needed on location to complete this step.

start_time

string

The time window start time for the pickup. Timezone: Europe/Amsterdam

end_time

string

The time window end time for the pickup. Timezone: Europe/Amsterdam

address

object

Address information for the pickup location.

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

delivery

object

The delivery step of the shipment.

delivery_duration_minutes

integer

The time needed on location to complete this step.

start_time

string

The time window start time for the delivery. Timezone: Europe/Amsterdam

end_time

string

The time window end time for the delivery. Timezone: Europe/Amsterdam

address

object

Address information for the delivery location.

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

POST Tasks

POST

https://api.routelogic.io

/api/v2/tasks

requires authentication

Create a task for your company. If the task already exists it will be updated based on the external identifier.

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

type

string

The type of this task.

Must be one of:

delivery
pickup
shipment

Example:

delivery

external_identifier

string

required

Unique identifier like order number. Must not be greater than 255 characters.

Example:

zzeseztujt

external_reference

string

Reference for api connections. Must not be greater than 255 characters.

Example:

icqsiugxwjtyuswykntoxho

note

string

Internal note for the driver / note from customer on order for the driver. Must not be greater than 20000 characters.

Example:

Please deliver at the side door.

pending_payment_amount

number

Amount the customer needs to pay on delivery. Must be at least 0. Must not be greater than 99999999.99.

Example:

100

external_link

string

Link visible on the track and trace page like a bill. Must not be greater than 2048 characters.

Example:

https://example.com/

delivery_from_date

string

The earliest date the task is allowed to be completed. Must be a valid date. Must be a date before or equal to delivery_date.

Example:

2025-02-28

start_time

string

The time window start time. Timezone: Europe/Amsterdam. This value can be null if the task should be an appointment and you have the appointments addon. Must be a valid date in the format H:i.

Example:

08:00

end_time

string

The time window end time. Timezone: Europe/Amsterdam. This value can be null if the task should be an appointment and you have the appointments addon. Must be a valid date in the format H:i. Must be a date after start_time.

Example:

17:00

delivery_duration_minutes

integer

The time needed on location to complete the task. Must be at least 0. Must not be greater than 1440.

Example:

return_required

boolean

Specifies if the task should also have a corresponding "pickup" task.

return_task_uuid

string

The uuid of the corresponding "pickup" task. Must be a valid UUID.

Example:

cb60924d-d7c8-39b9-b207-bcab23fc1d8b

signature_required

boolean

If the customer is required to place a signature for this task.

Example:

used_capacity

number

The amount of capacity this task takes. Must be at least 0. Must not be greater than 99999999.99.

Example:

used_capacity_2

number

The amount of capacity this task takes. Must be at least 0. Must not be greater than 99999999.99.

Example:

used_capacity_3

number

The amount of capacity this task takes. Must be at least 0. Must not be greater than 99999999.99.

Example:

notification_template_uuid

string

The uuid of the related notification template, null if using the default template. Must be a valid UUID.

Example:

960da920-7509-3285-b402-a484dbb91f69

recurring

object

Recurring information.

period

string

When a task is recurring. This field is required when recurring is present.

Must be one of:

week
month

Example:

month

interval

integer

The interval at which the task is repeated. This field is required when recurring is present. Must be at least 1. Must not be greater than 60.

Example:

settings

string

Settings when to repeat.

With a period of a week:
Example: [1,3,5] means that the task is repeated every monday, wednesday and friday

With a period of a month:
Example: ["number", 10] means the task is repeated on the 10th of every month.
Example: ["string", "third", "monday"] means the task is repeated on the third Monday of every month.

. This field is required when recurring is present.

Example:

["string", "third", "monday"]

end_date

string

When recurring should end. Must be a valid date. Must be a date after or equal to delivery_date.

Example:

2075-02-24

address

object

house_number

string

The house number. Must not be greater than 255 characters.

Example:

house_number_extension

string

Extra information about the house number. Must not be greater than 255 characters.

Example:

street

string

The street name. This field is required when address.latitude or address.longitude is not present. Must not be greater than 255 characters.

Example:

LongStreet

postal_code

string

The postal code. This field is required when address.latitude or address.longitude is not present. Must not be greater than 255 characters.

Example:

1234AB

city

string

The city. This field is required when address.latitude or address.longitude is not present. Must not be greater than 255 characters.

Example:

Amsterdam

country

string

required

The iso code of the country. The iso_code of an existing record in the countries table.

Example:

latitude

number

The latitude of the address. This field is required when address.city, address.street, or address.postal_code is not present. This field is required when address.longitude is present. Must be at least -90. Must not be greater than 90.

Example:

52.3676

longitude

number

The longitude of the address. This field is required when address.city, address.street, or address.postal_code is not present. This field is required when address.latitude is present. Must be at least -180. Must not be greater than 180.

Example:

4.9041

customer

object

tags

string[]

The identifier of a tag. Tasks with a tag will only be planned in to vehicles with the same tag. This field is required when tags is present. Must not be greater than 250 characters.

Example:

["cooled"]

delivery_date

string

required

The date the task is supposed to be completed. This value can be null if the task should be an appointment and you have the appointments addon. Must be a valid date.

Example:

2025-07-30T15:20:38

pickup_address

object

Pickup address information (required for shipment tasks). This field is required when type is shipment.

street

string

The pickup street name. This field is required when pickup_address.latitude or pickup_address.longitude is not present. Must not be greater than 255 characters.

Example:

PickupStreet

house_number

string

The pickup house number. This field is required when pickup_address.latitude or pickup_address.longitude is not present. Must not be greater than 255 characters.

Example:

postal_code

string

The pickup postal code. This field is required when pickup_address.latitude or pickup_address.longitude is not present. Must not be greater than 255 characters.

Example:

5678CD

city

string

The pickup city. This field is required when pickup_address.latitude or pickup_address.longitude is not present. Must not be greater than 255 characters.

Example:

Rotterdam

country

string

required

The iso code of the pickup country. The iso_code of an existing record in the countries table.

Example:

latitude

number

The latitude of the pickup address. This field is required when pickup_address.city, pickup_address.street, or pickup_address.postal_code is not present. This field is required when pickup_address.longitude is present. Must be at least -90. Must not be greater than 90.

Example:

52.3676

longitude

number

The longitude of the pickup address. This field is required when pickup_address.city, pickup_address.street, or pickup_address.postal_code is not present. This field is required when pickup_address.latitude is present. Must be at least -180. Must not be greater than 180.

Example:

4.9041

pickup_start_time

string

The pickup time window start time (for shipment tasks). Must be a valid date in the format H:i.

Example:

09:00

pickup_end_time

string

The pickup time window end time (for shipment tasks). Must be a valid date in the format H:i. Must be a date after pickup_start_time.

Example:

11:00

pickup_delivery_duration_minutes

integer

The time needed at pickup location to complete the pickup (for shipment tasks). Must be at least 0. Must not be greater than 1440.

Example:

Response Fields

uuid

string

The uuid of this task

type

string

enum(delivery|pickup|shipment) The type of this task

external_identifier

string

Unique identifier like order number

external_reference

string|null

Reference for api connections

note

string|null

Internal note for the driver / note from customer on order for the driver

pending_payment_amount

number

Amount the customer needs to pay on delivery

external_link

string|null

Link visible on the track and trace page like a bill

track_and_trace_link

string

Link to the track and trace page

delivery_from_date

string|null

The earliest date the task is allowed to be completed

delivery_date

string

The date the task is supposed to be completed

start_time

string|null

The time window start time. Timezone: Europe/Amsterdam

end_time

string|null

The time window end time. Timezone: Europe/Amsterdam

delivery_duration_minutes

integer

The time needed on location to complete the task

return_required

boolean

Specifies if the task should also have a corresponding 'pickup' task

signature_required

boolean

If the customer is required to place a signature for this task

used_capacity_1

integer

The amount of capacity this task takes

used_capacity_2

integer

The amount of capacity this task takes

used_capacity_3

integer

The amount of capacity this task takes

created_at

string

Date and time when this task was created

updated_at

string

Date and time when this task was updated

tags[]

string[]

The identifier of a tag. Tasks with a tag will only be planned in to vehicles with the same tag.

return_task_uuid

string|null

The uuid of a related return task if available

notification_template_uuid

string|null

The uuid of the related notification template, null if using the default template

recurring

object|null

Recurring information

address

object

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

customer

object

Customer information

next_visit

object|null

uuid

string

The uuid of this visit

type

string

enum(start|end|task|break|charge) The type of visit

order_index

integer

Index on which order the visits should be visited

delivery_time

string

The time which this visit should be completed

task_uuid

string|null

The related task to this visit

address

object|null

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country[]

object

Country information

country

object

scanned_codes

object[]|null

Collection of ScannedCodes

returnable_packaging

object[]|null

Collection of Returnable packaging

data

object

files

object[]|null

Collection of Files

data

object

shipment_steps

object|null

The shipment steps when a task has a shipment type. Shipments always consist of exactly 2 steps: pickup and delivery. The pickup step must be executed before the delivery step.

pickup

object

The pickup step of the shipment.

delivery_duration_minutes

integer

The time needed on location to complete this step.

start_time

string

The time window start time for the pickup. Timezone: Europe/Amsterdam

end_time

string

The time window end time for the pickup. Timezone: Europe/Amsterdam

address

object

Address information for the pickup location.

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

delivery

object

The delivery step of the shipment.

delivery_duration_minutes

integer

The time needed on location to complete this step.

start_time

string

The time window start time for the delivery. Timezone: Europe/Amsterdam

end_time

string

The time window end time for the delivery. Timezone: Europe/Amsterdam

address

object

Address information for the delivery location.

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

Auth

Bearer

Headers

Body

{ "type": "delivery", "external_identifier": "zzeseztujt", "external_reference": "icqsiugxwjtyuswykntoxho", "note": "Please deliver at the side door.", "pending_payment_amount": 100, "external_link": "https:\/\/example.com\/", "delivery_from_date": "2025-02-28", "start_time": "08:00", "end_time": "17:00", "delivery_duration_minutes": 24, "return_required": false, "return_task_uuid": "cb60924d-d7c8-39b9-b207-bcab23fc1d8b", "signature_required": true, "used_capacity": 2, "used_capacity_2": 15, "used_capacity_3": 19, "notification_template_uuid": "960da920-7509-3285-b402-a484dbb91f69", "recurring": { "period": "month", "interval": 15, "settings": "[\"string\", \"third\", \"monday\"]", "end_date": "2075-02-24" }, "address": { "house_number": "12", "house_number_extension": "1A", "street": "LongStreet", "postal_code": "1234AB", "city": "Amsterdam", "country": "NL", "latitude": 52.3676, "longitude": 4.9041 }, "customer": { "email": "[email protected]", "phone_number": "+01 234567890", "name": "Andrew" }, "tags": [ "cooled" ], "delivery_date": "2025-07-30T15:20:38", "pickup_address": { "street": "PickupStreet", "house_number": "42", "postal_code": "5678CD", "city": "Rotterdam", "country": "NL", "latitude": 52.3676, "longitude": 4.9041 }, "pickup_start_time": "09:00", "pickup_end_time": "11:00", "pickup_delivery_duration_minutes": 15 }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/tasks" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"type\": \"delivery\",
    \"external_identifier\": \"zzeseztujt\",
    \"external_reference\": \"icqsiugxwjtyuswykntoxho\",
    \"note\": \"Please deliver at the side door.\",
    \"pending_payment_amount\": 100,
    \"external_link\": \"https:\\/\\/example.com\\/\",
    \"delivery_from_date\": \"2025-02-28\",
    \"start_time\": \"08:00\",
    \"end_time\": \"17:00\",
    \"delivery_duration_minutes\": 24,
    \"return_required\": false,
    \"return_task_uuid\": \"cb60924d-d7c8-39b9-b207-bcab23fc1d8b\",
    \"signature_required\": true,
    \"used_capacity\": 2,
    \"used_capacity_2\": 15,
    \"used_capacity_3\": 19,
    \"notification_template_uuid\": \"960da920-7509-3285-b402-a484dbb91f69\",
    \"recurring\": {
        \"period\": \"month\",
        \"interval\": 15,
        \"settings\": \"[\\\"string\\\", \\\"third\\\", \\\"monday\\\"]\",
        \"end_date\": \"2075-02-24\"
    },
    \"address\": {
        \"house_number\": \"12\",
        \"house_number_extension\": \"1A\",
        \"street\": \"LongStreet\",
        \"postal_code\": \"1234AB\",
        \"city\": \"Amsterdam\",
        \"country\": \"NL\",
        \"latitude\": 52.3676,
        \"longitude\": 4.9041
    },
    \"customer\": {
        \"email\": \"[email protected]\",
        \"phone_number\": \"+01 234567890\",
        \"name\": \"Andrew\"
    },
    \"tags\": [
        \"cooled\"
    ],
    \"delivery_date\": \"2025-07-30T15:20:38\",
    \"pickup_address\": {
        \"street\": \"PickupStreet\",
        \"house_number\": \"42\",
        \"postal_code\": \"5678CD\",
        \"city\": \"Rotterdam\",
        \"country\": \"NL\",
        \"latitude\": 52.3676,
        \"longitude\": 4.9041
    },
    \"pickup_start_time\": \"09:00\",
    \"pickup_end_time\": \"11:00\",
    \"pickup_delivery_duration_minutes\": 15
}"

$client = new \GuzzleHttp\Client();
$url = 'https://api.routelogic.io/api/v2/tasks';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_API_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'type' => 'delivery',
            'external_identifier' => 'zzeseztujt',
            'external_reference' => 'icqsiugxwjtyuswykntoxho',
            'note' => 'Please deliver at the side door.',
            'pending_payment_amount' => 100.0,
            'external_link' => 'https://example.com/',
            'delivery_from_date' => '2025-02-28',
            'start_time' => '08:00',
            'end_time' => '17:00',
            'delivery_duration_minutes' => 24,
            'return_required' => false,
            'return_task_uuid' => 'cb60924d-d7c8-39b9-b207-bcab23fc1d8b',
            'signature_required' => true,
            'used_capacity' => 2,
            'used_capacity_2' => 15,
            'used_capacity_3' => 19,
            'notification_template_uuid' => '960da920-7509-3285-b402-a484dbb91f69',
            'recurring' => [
                'period' => 'month',
                'interval' => 15,
                'settings' => '["string", "third", "monday"]',
                'end_date' => '2075-02-24',
            ],
            'address' => [
                'house_number' => '12',
                'house_number_extension' => '1A',
                'street' => 'LongStreet',
                'postal_code' => '1234AB',
                'city' => 'Amsterdam',
                'country' => 'NL',
                'latitude' => 52.3676,
                'longitude' => 4.9041,
            ],
            'customer' => [
                'email' => '[email protected]',
                'phone_number' => '+01 234567890',
                'name' => 'Andrew',
            ],
            'tags' => [
                'cooled',
            ],
            'delivery_date' => '2025-07-30T15:20:38',
            'pickup_address' => [
                'street' => 'PickupStreet',
                'house_number' => '42',
                'postal_code' => '5678CD',
                'city' => 'Rotterdam',
                'country' => 'NL',
                'latitude' => 52.3676,
                'longitude' => 4.9041,
            ],
            'pickup_start_time' => '09:00',
            'pickup_end_time' => '11:00',
            'pickup_delivery_duration_minutes' => 15,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://api.routelogic.io/api/v2/tasks"
);

const headers = {
    "Authorization": "Bearer {YOUR_API_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "type": "delivery",
    "external_identifier": "zzeseztujt",
    "external_reference": "icqsiugxwjtyuswykntoxho",
    "note": "Please deliver at the side door.",
    "pending_payment_amount": 100,
    "external_link": "https:\/\/example.com\/",
    "delivery_from_date": "2025-02-28",
    "start_time": "08:00",
    "end_time": "17:00",
    "delivery_duration_minutes": 24,
    "return_required": false,
    "return_task_uuid": "cb60924d-d7c8-39b9-b207-bcab23fc1d8b",
    "signature_required": true,
    "used_capacity": 2,
    "used_capacity_2": 15,
    "used_capacity_3": 19,
    "notification_template_uuid": "960da920-7509-3285-b402-a484dbb91f69",
    "recurring": {
        "period": "month",
        "interval": 15,
        "settings": "[\"string\", \"third\", \"monday\"]",
        "end_date": "2075-02-24"
    },
    "address": {
        "house_number": "12",
        "house_number_extension": "1A",
        "street": "LongStreet",
        "postal_code": "1234AB",
        "city": "Amsterdam",
        "country": "NL",
        "latitude": 52.3676,
        "longitude": 4.9041
    },
    "customer": {
        "email": "[email protected]",
        "phone_number": "+01 234567890",
        "name": "Andrew"
    },
    "tags": [
        "cooled"
    ],
    "delivery_date": "2025-07-30T15:20:38",
    "pickup_address": {
        "street": "PickupStreet",
        "house_number": "42",
        "postal_code": "5678CD",
        "city": "Rotterdam",
        "country": "NL",
        "latitude": 52.3676,
        "longitude": 4.9041
    },
    "pickup_start_time": "09:00",
    "pickup_end_time": "11:00",
    "pickup_delivery_duration_minutes": 15
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

import requests
import json

url = 'https://api.routelogic.io/api/v2/tasks'
payload = {
    "type": "delivery",
    "external_identifier": "zzeseztujt",
    "external_reference": "icqsiugxwjtyuswykntoxho",
    "note": "Please deliver at the side door.",
    "pending_payment_amount": 100,
    "external_link": "https:\/\/example.com\/",
    "delivery_from_date": "2025-02-28",
    "start_time": "08:00",
    "end_time": "17:00",
    "delivery_duration_minutes": 24,
    "return_required": false,
    "return_task_uuid": "cb60924d-d7c8-39b9-b207-bcab23fc1d8b",
    "signature_required": true,
    "used_capacity": 2,
    "used_capacity_2": 15,
    "used_capacity_3": 19,
    "notification_template_uuid": "960da920-7509-3285-b402-a484dbb91f69",
    "recurring": {
        "period": "month",
        "interval": 15,
        "settings": "[\"string\", \"third\", \"monday\"]",
        "end_date": "2075-02-24"
    },
    "address": {
        "house_number": "12",
        "house_number_extension": "1A",
        "street": "LongStreet",
        "postal_code": "1234AB",
        "city": "Amsterdam",
        "country": "NL",
        "latitude": 52.3676,
        "longitude": 4.9041
    },
    "customer": {
        "email": "[email protected]",
        "phone_number": "+01 234567890",
        "name": "Andrew"
    },
    "tags": [
        "cooled"
    ],
    "delivery_date": "2025-07-30T15:20:38",
    "pickup_address": {
        "street": "PickupStreet",
        "house_number": "42",
        "postal_code": "5678CD",
        "city": "Rotterdam",
        "country": "NL",
        "latitude": 52.3676,
        "longitude": 4.9041
    },
    "pickup_start_time": "09:00",
    "pickup_end_time": "11:00",
    "pickup_delivery_duration_minutes": 15
}
headers = {
  'Authorization': 'Bearer {YOUR_API_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response:

{
    "uuid": "9f83bd31-4203-4343-a567-9bfe33a9c573",
    "type": "delivery",
    "external_identifier": "RL4XFcAiKUwh",
    "external_reference": null,
    "note": null,
    "pending_payment_amount": 0,
    "external_link": null,
    "track_and_trace_link": "http://localhost/tr/Vy65uQBQ6now",
    "delivery_from_date": null,
    "delivery_date": "2025-07-30",
    "start_time": "08:00:00",
    "end_time": "18:00:00",
    "delivery_duration_minutes": 5,
    "recurring": null,
    "return_required": false,
    "signature_required": false,
    "used_capacity": 0,
    "used_capacity_2": 0,
    "used_capacity_3": 0,
    "updated_at": "2025-07-30T13:20:36.000000Z",
    "created_at": "2025-07-30T13:20:36.000000Z",
    "tags": [],
    "notification_template_uuid": null,
    "return_task_uuid": null,
    "address": {
        "street": "",
        "house_number": "",
        "house_number_extension": "",
        "postal_code": "",
        "city": "",
        "latitude": 5.4321,
        "longitude": 5.4321,
        "address_line": "",
        "full_address_line": "",
        "country": {
            "iso_code": "NL",
            "description": "Nederland"
        }
    },
    "customer": {
        "name": "customer 1",
        "email": null,
        "phone_number": null
    },
    "shipment_steps": null,
    "next_visit": null
}

GET Task

GET

https://api.routelogic.io

/api/v2/tasks/{task_uuid}

requires authentication

Get a task from your company

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

58527419-a793-3836-90e4-9db1569a489d

Response Fields

uuid

string

The uuid of this task

type

string

enum(delivery|pickup|shipment) The type of this task

external_identifier

string

Unique identifier like order number

external_reference

string|null

Reference for api connections

note

string|null

Internal note for the driver / note from customer on order for the driver

pending_payment_amount

number

Amount the customer needs to pay on delivery

external_link

string|null

Link visible on the track and trace page like a bill

track_and_trace_link

string

Link to the track and trace page

delivery_from_date

string|null

The earliest date the task is allowed to be completed

delivery_date

string

The date the task is supposed to be completed

start_time

string|null

The time window start time. Timezone: Europe/Amsterdam

end_time

string|null

The time window end time. Timezone: Europe/Amsterdam

delivery_duration_minutes

integer

The time needed on location to complete the task

return_required

boolean

Specifies if the task should also have a corresponding 'pickup' task

signature_required

boolean

If the customer is required to place a signature for this task

used_capacity_1

integer

The amount of capacity this task takes

used_capacity_2

integer

The amount of capacity this task takes

used_capacity_3

integer

The amount of capacity this task takes

created_at

string

Date and time when this task was created

updated_at

string

Date and time when this task was updated

tags[]

string[]

The identifier of a tag. Tasks with a tag will only be planned in to vehicles with the same tag.

return_task_uuid

string|null

The uuid of a related return task if available

notification_template_uuid

string|null

The uuid of the related notification template, null if using the default template

recurring

object|null

Recurring information

address

object

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

customer

object

Customer information

next_visit

object|null

uuid

string

The uuid of this visit

type

string

enum(start|end|task|break|charge) The type of visit

order_index

integer

Index on which order the visits should be visited

delivery_time

string

The time which this visit should be completed

task_uuid

string|null

The related task to this visit

address

object|null

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country[]

object

Country information

country

object

scanned_codes

object[]|null

Collection of ScannedCodes

returnable_packaging

object[]|null

Collection of Returnable packaging

data

object

files

object[]|null

Collection of Files

data

object

shipment_steps

object|null

The shipment steps when a task has a shipment type. Shipments always consist of exactly 2 steps: pickup and delivery. The pickup step must be executed before the delivery step.

pickup

object

The pickup step of the shipment.

delivery_duration_minutes

integer

The time needed on location to complete this step.

start_time

string

The time window start time for the pickup. Timezone: Europe/Amsterdam

end_time

string

The time window end time for the pickup. Timezone: Europe/Amsterdam

address

object

Address information for the pickup location.

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

delivery

object

The delivery step of the shipment.

delivery_duration_minutes

integer

The time needed on location to complete this step.

start_time

string

The time window start time for the delivery. Timezone: Europe/Amsterdam

end_time

string

The time window end time for the delivery. Timezone: Europe/Amsterdam

address

object

Address information for the delivery location.

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/tasks/58527419-a793-3836-90e4-9db1569a489d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
    "type": "delivery",
    "external_identifier": "JHtiqp",
    "external_reference": null,
    "note": null,
    "pending_payment_amount": 0,
    "external_link": null,
    "track_and_trace_link": "http://localhost/tr/ldfNe7h6Noos",
    "delivery_from_date": null,
    "delivery_date": "2025-07-30",
    "start_time": "08:00:00",
    "end_time": "17:00:00",
    "delivery_duration_minutes": 0,
    "recurring": null,
    "return_required": false,
    "signature_required": false,
    "used_capacity": 0,
    "used_capacity_2": 0,
    "used_capacity_3": 0,
    "updated_at": "2025-07-30T13:20:35.000000Z",
    "created_at": "2025-07-30T13:20:35.000000Z",
    "tags": [],
    "notification_template_uuid": null,
    "return_task_uuid": null,
    "address": {
        "street": "49453 McDermott Isle",
        "house_number": "93094",
        "house_number_extension": null,
        "postal_code": "17133-5980",
        "city": "Cristobalberg",
        "latitude": 5.4321,
        "longitude": 5.4321,
        "address_line": "49453 McDermott Isle 93094",
        "full_address_line": "49453 McDermott Isle 93094, 17133-5980, Cristobalberg",
        "country": {
            "iso_code": "NL",
            "description": "Nederland"
        }
    },
    "customer": {
        "name": "Jessie Daniel",
        "email": null,
        "phone_number": null
    },
    "shipment_steps": null,
    "next_visit": {
        "uuid": "9f83bd30-0828-47b0-81ec-fed874c80ccf",
        "type": "task",
        "order_index": 0,
        "delivery_time": "09:00:00",
        "schedule_date": "2025-07-29T22:00:00.000000Z",
        "address": {
            "street": "49453 McDermott Isle",
            "house_number": "93094",
            "house_number_extension": null,
            "postal_code": "17133-5980",
            "city": "Cristobalberg",
            "latitude": 5.4321,
            "longitude": 5.4321,
            "address_line": "49453 McDermott Isle 93094",
            "full_address_line": "49453 McDermott Isle 93094, 17133-5980, Cristobalberg",
            "country": {
                "iso_code": "NL",
                "description": "Nederland"
            }
        },
        "scanned_codes": {
            "data": [
                {
                    "type": "task_code",
                    "code_uuid": "9f83bd30-048f-4840-913e-fcdeff4dd5ae",
                    "scanned_count": 1
                },
                {
                    "type": "schedule_visit_code",
                    "code_uuid": "9f83bd30-11c7-4276-bc2e-fd509cca74ba",
                    "scanned_count": 1
                }
            ]
        },
        "returnable_packaging": {
            "data": [
                {
                    "uuid": "9f83bd30-1605-436b-8440-9d2ca5e24409",
                    "count": -2,
                    "returnable_packaging_type": {
                        "uuid": "9f83bd30-153f-446f-b826-fec185b24e40",
                        "type": "pallets"
                    }
                }
            ]
        },
        "status": {
            "status_identifier": "delivered"
        },
        "signature": "OWY4M2JkMzAtMDgyOC00N2IwLTgxZWMtZmVkODc0YzgwY2Nm",
        "files": {
            "data": [
                {
                    "type": "image",
                    "key": "Q21hYVk5MkxaTk5GZkNIcw"
                }
            ]
        }
    }
}

PUT/PATCH Task

PUT

PATCH

https://api.routelogic.io

/api/v2/tasks/{task_uuid}

requires authentication

Update a task from your company

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

4c8b5c27-4612-3416-a9c8-6dafc379c45c

Body Parameters

type

string

The type of this task.

Must be one of:

delivery
pickup
shipment

Example:

delivery

external_identifier

string

required

Unique identifier like order number. Must not be greater than 255 characters.

Example:

zbdiyyaad

external_reference

string

Reference for api connections. Must not be greater than 255 characters.

Example:

jjrcparcnkwyhknxe

note

string

Internal note for the driver / note from customer on order for the driver. Must not be greater than 20000 characters.

Example:

Please deliver at the side door.

pending_payment_amount

number

Amount the customer needs to pay on delivery. Must be at least 0. Must not be greater than 99999999.99.

Example:

100

external_link

string

Link visible on the track and trace page like a bill. Must not be greater than 2048 characters.

Example:

https://example.com/

delivery_from_date

string

The earliest date the task is allowed to be completed. Must be a valid date. Must be a date before or equal to delivery_date.

Example:

2002-08-27

start_time

string

The time window start time. Timezone: Europe/Amsterdam. This value can be null if the task should be an appointment and you have the appointments addon. Must be a valid date in the format H:i.

Example:

08:00

end_time

string

Example:

17:00

delivery_duration_minutes

integer

The time needed on location to complete the task. Must be at least 0. Must not be greater than 1440.

Example:

return_required

boolean

Specifies if the task should also have a corresponding "pickup" task.

return_task_uuid

string

The uuid of the corresponding "pickup" task. Must be a valid UUID.

Example:

7b19ba39-cab2-3ec8-9450-139707b9ef34

signature_required

boolean

If the customer is required to place a signature for this task.

Example:

used_capacity

number

The amount of capacity this task takes. Must be at least 0. Must not be greater than 99999999.99.

Example:

used_capacity_2

number

The amount of capacity this task takes. Must be at least 0. Must not be greater than 99999999.99.

Example:

used_capacity_3

number

The amount of capacity this task takes. Must be at least 0. Must not be greater than 99999999.99.

Example:

notification_template_uuid

string

The uuid of the related notification template, null if using the default template. Must be a valid UUID.

Example:

1f07e281-a9cd-38c9-9991-fbd58e0d391d

recurring

object

Recurring information.

period

string

When a task is recurring. This field is required when recurring is present.

Must be one of:

week
month

Example:

week

interval

integer

The interval at which the task is repeated. This field is required when recurring is present. Must be at least 1. Must not be greater than 60.

Example:

settings

string

Settings when to repeat.

. This field is required when recurring is present.

Example:

["string", "third", "monday"]

end_date

string

When recurring should end. Must be a valid date. Must be a date after or equal to delivery_date.

Example:

2033-12-29

address

object

house_number

string

The house number. Must not be greater than 255 characters.

Example:

house_number_extension

string

Extra information about the house number. Must not be greater than 255 characters.

Example:

street

string

The street name. Must not be greater than 255 characters.

Example:

LongStreet

postal_code

string

The postal code. Must not be greater than 255 characters.

Example:

1234AB

city

string

The city. Must not be greater than 255 characters.

Example:

Amsterdam

country

string

The iso code of the country. The iso_code of an existing record in the countries table.

Example:

latitude

number

The latitude of the address. This field is required when address.longitude is present. Must be at least -90. Must not be greater than 90.

Example:

52.3676

longitude

number

The longitude of the address. This field is required when address.latitude is present. Must be at least -180. Must not be greater than 180.

Example:

4.9041

customer

object

tags

string[]

The identifier of a tag. Tasks with a tag will only be planned in to vehicles with the same tag. This field is required when tags is present. Must not be greater than 250 characters.

Example:

["cooled"]

delivery_date

string

The date the task is supposed to be completed. This value can be null if the task should be an appointment and you have the appointments addon. Must be a valid date.

Example:

2025-07-30T15:20:38

pickup_address

object

Pickup address information (required for shipment tasks).

street

string

The pickup street name. This field is required when pickup_address.latitude or pickup_address.longitude is not present. Must not be greater than 255 characters.

Example:

PickupStreet

house_number

string

The pickup house number. This field is required when pickup_address.latitude or pickup_address.longitude is not present. Must not be greater than 255 characters.

Example:

postal_code

string

The pickup postal code. This field is required when pickup_address.latitude or pickup_address.longitude is not present. Must not be greater than 255 characters.

Example:

5678CD

city

string

The pickup city. This field is required when pickup_address.latitude or pickup_address.longitude is not present. Must not be greater than 255 characters.

Example:

Rotterdam

country

string

required

The iso code of the pickup country. The iso_code of an existing record in the countries table.

Example:

latitude

number

Example:

52.3676

longitude

number

Example:

4.9041

pickup_start_time

string

The pickup time window start time (for shipment tasks). Must be a valid date in the format H:i.

Example:

09:00

pickup_end_time

string

The pickup time window end time (for shipment tasks). Must be a valid date in the format H:i. Must be a date after pickup_start_time.

Example:

11:00

pickup_delivery_duration_minutes

integer

The time needed at pickup location to complete the pickup (for shipment tasks). Must be at least 0. Must not be greater than 1440.

Example:

Response Fields

uuid

string

The uuid of this task

type

string

enum(delivery|pickup|shipment) The type of this task

external_identifier

string

Unique identifier like order number

external_reference

string|null

Reference for api connections

note

string|null

Internal note for the driver / note from customer on order for the driver

pending_payment_amount

number

Amount the customer needs to pay on delivery

external_link

string|null

Link visible on the track and trace page like a bill

track_and_trace_link

string

Link to the track and trace page

delivery_from_date

string|null

The earliest date the task is allowed to be completed

delivery_date

string

The date the task is supposed to be completed

start_time

string|null

The time window start time. Timezone: Europe/Amsterdam

end_time

string|null

The time window end time. Timezone: Europe/Amsterdam

delivery_duration_minutes

integer

The time needed on location to complete the task

return_required

boolean

Specifies if the task should also have a corresponding 'pickup' task

signature_required

boolean

If the customer is required to place a signature for this task

used_capacity_1

integer

The amount of capacity this task takes

used_capacity_2

integer

The amount of capacity this task takes

used_capacity_3

integer

The amount of capacity this task takes

created_at

string

Date and time when this task was created

updated_at

string

Date and time when this task was updated

tags[]

string[]

The identifier of a tag. Tasks with a tag will only be planned in to vehicles with the same tag.

return_task_uuid

string|null

The uuid of a related return task if available

notification_template_uuid

string|null

The uuid of the related notification template, null if using the default template

recurring

object|null

Recurring information

address

object

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

customer

object

Customer information

next_visit

object|null

uuid

string

The uuid of this visit

type

string

enum(start|end|task|break|charge) The type of visit

order_index

integer

Index on which order the visits should be visited

delivery_time

string

The time which this visit should be completed

task_uuid

string|null

The related task to this visit

address

object|null

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country[]

object

Country information

country

object

scanned_codes

object[]|null

Collection of ScannedCodes

returnable_packaging

object[]|null

Collection of Returnable packaging

data

object

files

object[]|null

Collection of Files

data

object

shipment_steps

object|null

The shipment steps when a task has a shipment type. Shipments always consist of exactly 2 steps: pickup and delivery. The pickup step must be executed before the delivery step.

pickup

object

The pickup step of the shipment.

delivery_duration_minutes

integer

The time needed on location to complete this step.

start_time

string

The time window start time for the pickup. Timezone: Europe/Amsterdam

end_time

string

The time window end time for the pickup. Timezone: Europe/Amsterdam

address

object

Address information for the pickup location.

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

delivery

object

The delivery step of the shipment.

delivery_duration_minutes

integer

The time needed on location to complete this step.

start_time

string

The time window start time for the delivery. Timezone: Europe/Amsterdam

end_time

string

The time window end time for the delivery. Timezone: Europe/Amsterdam

address

object

Address information for the delivery location.

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

Auth

Bearer

Headers

URL Parameters

Body

{ "type": "delivery", "external_identifier": "zbdiyyaad", "external_reference": "jjrcparcnkwyhknxe", "note": "Please deliver at the side door.", "pending_payment_amount": 100, "external_link": "https:\/\/example.com\/", "delivery_from_date": "2002-08-27", "start_time": "08:00", "end_time": "17:00", "delivery_duration_minutes": 25, "return_required": false, "return_task_uuid": "7b19ba39-cab2-3ec8-9450-139707b9ef34", "signature_required": true, "used_capacity": 15, "used_capacity_2": 13, "used_capacity_3": 21, "notification_template_uuid": "1f07e281-a9cd-38c9-9991-fbd58e0d391d", "recurring": { "period": "week", "interval": 21, "settings": "[\"string\", \"third\", \"monday\"]", "end_date": "2033-12-29" }, "address": { "house_number": "12", "house_number_extension": "1A", "street": "LongStreet", "postal_code": "1234AB", "city": "Amsterdam", "country": "NL", "latitude": 52.3676, "longitude": 4.9041 }, "customer": { "email": "[email protected]", "phone_number": "+01 234567890", "name": "Andrew" }, "tags": [ "cooled" ], "delivery_date": "2025-07-30T15:20:38", "pickup_address": { "street": "PickupStreet", "house_number": "42", "postal_code": "5678CD", "city": "Rotterdam", "country": "NL", "latitude": 52.3676, "longitude": 4.9041 }, "pickup_start_time": "09:00", "pickup_end_time": "11:00", "pickup_delivery_duration_minutes": 15 }

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/tasks/4c8b5c27-4612-3416-a9c8-6dafc379c45c" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"type\": \"delivery\",
    \"external_identifier\": \"zbdiyyaad\",
    \"external_reference\": \"jjrcparcnkwyhknxe\",
    \"note\": \"Please deliver at the side door.\",
    \"pending_payment_amount\": 100,
    \"external_link\": \"https:\\/\\/example.com\\/\",
    \"delivery_from_date\": \"2002-08-27\",
    \"start_time\": \"08:00\",
    \"end_time\": \"17:00\",
    \"delivery_duration_minutes\": 25,
    \"return_required\": false,
    \"return_task_uuid\": \"7b19ba39-cab2-3ec8-9450-139707b9ef34\",
    \"signature_required\": true,
    \"used_capacity\": 15,
    \"used_capacity_2\": 13,
    \"used_capacity_3\": 21,
    \"notification_template_uuid\": \"1f07e281-a9cd-38c9-9991-fbd58e0d391d\",
    \"recurring\": {
        \"period\": \"week\",
        \"interval\": 21,
        \"settings\": \"[\\\"string\\\", \\\"third\\\", \\\"monday\\\"]\",
        \"end_date\": \"2033-12-29\"
    },
    \"address\": {
        \"house_number\": \"12\",
        \"house_number_extension\": \"1A\",
        \"street\": \"LongStreet\",
        \"postal_code\": \"1234AB\",
        \"city\": \"Amsterdam\",
        \"country\": \"NL\",
        \"latitude\": 52.3676,
        \"longitude\": 4.9041
    },
    \"customer\": {
        \"email\": \"[email protected]\",
        \"phone_number\": \"+01 234567890\",
        \"name\": \"Andrew\"
    },
    \"tags\": [
        \"cooled\"
    ],
    \"delivery_date\": \"2025-07-30T15:20:38\",
    \"pickup_address\": {
        \"street\": \"PickupStreet\",
        \"house_number\": \"42\",
        \"postal_code\": \"5678CD\",
        \"city\": \"Rotterdam\",
        \"country\": \"NL\",
        \"latitude\": 52.3676,
        \"longitude\": 4.9041
    },
    \"pickup_start_time\": \"09:00\",
    \"pickup_end_time\": \"11:00\",
    \"pickup_delivery_duration_minutes\": 15
}"

$client = new \GuzzleHttp\Client();
$url = 'https://api.routelogic.io/api/v2/tasks/4c8b5c27-4612-3416-a9c8-6dafc379c45c';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_API_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'type' => 'delivery',
            'external_identifier' => 'zbdiyyaad',
            'external_reference' => 'jjrcparcnkwyhknxe',
            'note' => 'Please deliver at the side door.',
            'pending_payment_amount' => 100.0,
            'external_link' => 'https://example.com/',
            'delivery_from_date' => '2002-08-27',
            'start_time' => '08:00',
            'end_time' => '17:00',
            'delivery_duration_minutes' => 25,
            'return_required' => false,
            'return_task_uuid' => '7b19ba39-cab2-3ec8-9450-139707b9ef34',
            'signature_required' => true,
            'used_capacity' => 15,
            'used_capacity_2' => 13,
            'used_capacity_3' => 21,
            'notification_template_uuid' => '1f07e281-a9cd-38c9-9991-fbd58e0d391d',
            'recurring' => [
                'period' => 'week',
                'interval' => 21,
                'settings' => '["string", "third", "monday"]',
                'end_date' => '2033-12-29',
            ],
            'address' => [
                'house_number' => '12',
                'house_number_extension' => '1A',
                'street' => 'LongStreet',
                'postal_code' => '1234AB',
                'city' => 'Amsterdam',
                'country' => 'NL',
                'latitude' => 52.3676,
                'longitude' => 4.9041,
            ],
            'customer' => [
                'email' => '[email protected]',
                'phone_number' => '+01 234567890',
                'name' => 'Andrew',
            ],
            'tags' => [
                'cooled',
            ],
            'delivery_date' => '2025-07-30T15:20:38',
            'pickup_address' => [
                'street' => 'PickupStreet',
                'house_number' => '42',
                'postal_code' => '5678CD',
                'city' => 'Rotterdam',
                'country' => 'NL',
                'latitude' => 52.3676,
                'longitude' => 4.9041,
            ],
            'pickup_start_time' => '09:00',
            'pickup_end_time' => '11:00',
            'pickup_delivery_duration_minutes' => 15,
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

const url = new URL(
    "https://api.routelogic.io/api/v2/tasks/4c8b5c27-4612-3416-a9c8-6dafc379c45c"
);

const headers = {
    "Authorization": "Bearer {YOUR_API_KEY}",
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "type": "delivery",
    "external_identifier": "zbdiyyaad",
    "external_reference": "jjrcparcnkwyhknxe",
    "note": "Please deliver at the side door.",
    "pending_payment_amount": 100,
    "external_link": "https:\/\/example.com\/",
    "delivery_from_date": "2002-08-27",
    "start_time": "08:00",
    "end_time": "17:00",
    "delivery_duration_minutes": 25,
    "return_required": false,
    "return_task_uuid": "7b19ba39-cab2-3ec8-9450-139707b9ef34",
    "signature_required": true,
    "used_capacity": 15,
    "used_capacity_2": 13,
    "used_capacity_3": 21,
    "notification_template_uuid": "1f07e281-a9cd-38c9-9991-fbd58e0d391d",
    "recurring": {
        "period": "week",
        "interval": 21,
        "settings": "[\"string\", \"third\", \"monday\"]",
        "end_date": "2033-12-29"
    },
    "address": {
        "house_number": "12",
        "house_number_extension": "1A",
        "street": "LongStreet",
        "postal_code": "1234AB",
        "city": "Amsterdam",
        "country": "NL",
        "latitude": 52.3676,
        "longitude": 4.9041
    },
    "customer": {
        "email": "[email protected]",
        "phone_number": "+01 234567890",
        "name": "Andrew"
    },
    "tags": [
        "cooled"
    ],
    "delivery_date": "2025-07-30T15:20:38",
    "pickup_address": {
        "street": "PickupStreet",
        "house_number": "42",
        "postal_code": "5678CD",
        "city": "Rotterdam",
        "country": "NL",
        "latitude": 52.3676,
        "longitude": 4.9041
    },
    "pickup_start_time": "09:00",
    "pickup_end_time": "11:00",
    "pickup_delivery_duration_minutes": 15
};

fetch(url, {
    method: "PUT",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());

import requests
import json

url = 'https://api.routelogic.io/api/v2/tasks/4c8b5c27-4612-3416-a9c8-6dafc379c45c'
payload = {
    "type": "delivery",
    "external_identifier": "zbdiyyaad",
    "external_reference": "jjrcparcnkwyhknxe",
    "note": "Please deliver at the side door.",
    "pending_payment_amount": 100,
    "external_link": "https:\/\/example.com\/",
    "delivery_from_date": "2002-08-27",
    "start_time": "08:00",
    "end_time": "17:00",
    "delivery_duration_minutes": 25,
    "return_required": false,
    "return_task_uuid": "7b19ba39-cab2-3ec8-9450-139707b9ef34",
    "signature_required": true,
    "used_capacity": 15,
    "used_capacity_2": 13,
    "used_capacity_3": 21,
    "notification_template_uuid": "1f07e281-a9cd-38c9-9991-fbd58e0d391d",
    "recurring": {
        "period": "week",
        "interval": 21,
        "settings": "[\"string\", \"third\", \"monday\"]",
        "end_date": "2033-12-29"
    },
    "address": {
        "house_number": "12",
        "house_number_extension": "1A",
        "street": "LongStreet",
        "postal_code": "1234AB",
        "city": "Amsterdam",
        "country": "NL",
        "latitude": 52.3676,
        "longitude": 4.9041
    },
    "customer": {
        "email": "[email protected]",
        "phone_number": "+01 234567890",
        "name": "Andrew"
    },
    "tags": [
        "cooled"
    ],
    "delivery_date": "2025-07-30T15:20:38",
    "pickup_address": {
        "street": "PickupStreet",
        "house_number": "42",
        "postal_code": "5678CD",
        "city": "Rotterdam",
        "country": "NL",
        "latitude": 52.3676,
        "longitude": 4.9041
    },
    "pickup_start_time": "09:00",
    "pickup_end_time": "11:00",
    "pickup_delivery_duration_minutes": 15
}
headers = {
  'Authorization': 'Bearer {YOUR_API_KEY}',
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('PUT', url, headers=headers, json=payload)
response.json()

Example response:

{
    "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
    "type": "delivery",
    "external_identifier": "RLuGyLuEKnzC",
    "external_reference": null,
    "note": null,
    "pending_payment_amount": 0,
    "external_link": null,
    "track_and_trace_link": "http://localhost/tr/ldfNe7h6Noos",
    "delivery_from_date": null,
    "delivery_date": "2025-07-30",
    "start_time": "08:00:00",
    "end_time": "17:00:00",
    "delivery_duration_minutes": 0,
    "recurring": null,
    "return_required": false,
    "signature_required": false,
    "used_capacity": 0,
    "used_capacity_2": 0,
    "used_capacity_3": 0,
    "updated_at": "2025-07-30T13:20:36.000000Z",
    "created_at": "2025-07-30T13:20:35.000000Z",
    "tags": [],
    "notification_template_uuid": null,
    "return_task_uuid": null,
    "address": {
        "street": "49453 McDermott Isle",
        "house_number": "93094",
        "house_number_extension": null,
        "postal_code": "17133-5980",
        "city": "Cristobalberg",
        "latitude": 5.4321,
        "longitude": 5.4321,
        "address_line": "49453 McDermott Isle 93094",
        "full_address_line": "49453 McDermott Isle 93094, 17133-5980, Cristobalberg",
        "country": {
            "iso_code": "NL",
            "description": "Nederland"
        }
    },
    "customer": {
        "name": "Jessie Daniel",
        "email": null,
        "phone_number": null
    },
    "shipment_steps": null,
    "next_visit": {
        "uuid": "9f83bd30-0828-47b0-81ec-fed874c80ccf",
        "type": "task",
        "order_index": 0,
        "delivery_time": "09:00:00",
        "schedule_date": "2025-07-29T22:00:00.000000Z",
        "address": {
            "street": "49453 McDermott Isle",
            "house_number": "93094",
            "house_number_extension": null,
            "postal_code": "17133-5980",
            "city": "Cristobalberg",
            "latitude": 5.4321,
            "longitude": 5.4321,
            "address_line": "49453 McDermott Isle 93094",
            "full_address_line": "49453 McDermott Isle 93094, 17133-5980, Cristobalberg",
            "country": {
                "iso_code": "NL",
                "description": "Nederland"
            }
        },
        "scanned_codes": {
            "data": [
                {
                    "type": "task_code",
                    "code_uuid": "9f83bd30-048f-4840-913e-fcdeff4dd5ae",
                    "scanned_count": 1
                },
                {
                    "type": "schedule_visit_code",
                    "code_uuid": "9f83bd30-11c7-4276-bc2e-fd509cca74ba",
                    "scanned_count": 1
                }
            ]
        },
        "returnable_packaging": {
            "data": [
                {
                    "uuid": "9f83bd30-1605-436b-8440-9d2ca5e24409",
                    "count": -2,
                    "returnable_packaging_type": {
                        "uuid": "9f83bd30-153f-446f-b826-fec185b24e40",
                        "type": "pallets"
                    }
                }
            ]
        },
        "status": {
            "status_identifier": "delivered"
        },
        "signature": "OWY4M2JkMzAtMDgyOC00N2IwLTgxZWMtZmVkODc0YzgwY2Nm",
        "files": {
            "data": [
                {
                    "type": "image",
                    "key": "Q21hYVk5MkxaTk5GZkNIcw"
                }
            ]
        }
    }
}

DELETE Task

DELETE

https://api.routelogic.io

/api/v2/tasks/{task_uuid}

requires authentication

Delete a task from your company

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

4fb1c66e-c621-3780-845e-49a8c07cc0b6

Query Parameters

forceRemoveFromSchedules

boolean

Optionally force remove task from all schedules.

Auth

Bearer

Headers

URL Parameters

Query Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/tasks/4fb1c66e-c621-3780-845e-49a8c07cc0b6?forceRemoveFromSchedules=" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[Empty response]

Task Products

Products are the items that are being delivered or picked up in a task.

GET Products

GET

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/products

requires authentication

Get collection of products of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

16002212-60cd-38f9-903c-4bab30c69b46

Response Fields

data

object[]

Collection of products

object

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/tasks/16002212-60cd-38f9-903c-4bab30c69b46/products" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f83bd30-0368-4973-a038-304ca913b87b",
            "quantity": "1.00",
            "description": "Test line",
            "unit": "pieces",
            "identifier": "2f7e673aae64ffbe3821016e253b45ed"
        }
    ]
}

POST Products

POST

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/products

requires authentication

Create a or multiple products of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

d7370b2c-f761-3766-b71d-88117e9368d4

Body Parameters

data

object[]

identifier

string

Identifier so items can be grouped with different descriptions Example: If you classify both the Oak tree and Birch tree under the identifier "tree", they will be grouped together on the vehicle product list. Must not be greater than 255 characters.

Example:

ypdytqwn

quantity

number

The quantity of this product. Must be at least 0.01. Must not be greater than 99999999.99.

Example:

unit

string

The unit of this product.

Must be one of:

pieces
weight

Example:

weight

description

string

required

The description of this product. Must not be greater than 2000 characters.

Example:

Table

Response Fields

data

object[]

Collection of products

object

Auth

Bearer

Headers

URL Parameters

Body

{ "data": [ { "identifier": "ypdytqwn", "quantity": 2, "unit": "weight", "description": "Table" } ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/tasks/d7370b2c-f761-3766-b71d-88117e9368d4/products" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": [
        {
            \"identifier\": \"ypdytqwn\",
            \"quantity\": 2,
            \"unit\": \"weight\",
            \"description\": \"Table\"
        }
    ]
}"

Example response:

{
    "data": [
        {
            "uuid": "9f83bd31-f9af-402e-813d-f2ee8f1484b0",
            "quantity": 1,
            "description": "Test line",
            "unit": "pieces",
            "identifier": "2f7e673aae64ffbe3821016e253b45ed"
        },
        {
            "uuid": "9f83bd31-fa78-46bb-8e40-f26869f73a5e",
            "quantity": 5,
            "description": "Test line 2",
            "unit": "weight",
            "identifier": "838c87eb890a63944ecc8e83ffb0e4bb"
        }
    ]
}

GET Product

GET

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/products/{product_uuid}

requires authentication

Get a product of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

921f782c-115b-30a5-9df1-e04cb02e2b82

product_uuid

string

uuid of the corresponding product

Example:

5ed83de7-0210-3e9e-bf1c-0238f1db4cd2

Response Fields

uuid

string

The uuid of this product

quantity

number

The quantity of this product

description

string

The description of this product

unit

string

enum(pieces|weight) The unit of this product

identifier

string|null

Identifier so items can be grouped with different descriptions Example: u have 2 products Oak tree and Birch tree if u give these both the identifier of tree. These will then be grouped on the vehicle product list.

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/tasks/921f782c-115b-30a5-9df1-e04cb02e2b82/products/5ed83de7-0210-3e9e-bf1c-0238f1db4cd2" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f83bd30-0368-4973-a038-304ca913b87b",
        "quantity": "1.00",
        "description": "Test line",
        "unit": "pieces",
        "identifier": "2f7e673aae64ffbe3821016e253b45ed"
    }
}

PUT/PATCH Product

PUT

PATCH

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/products/{product_uuid}

requires authentication

Update a product of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

8759f1ee-2376-38f4-b523-5d5244ccfb44

product_uuid

string

uuid of the corresponding product

Example:

e76bfa24-eafd-3209-b66c-f12c6c54c484

Body Parameters

identifier

string

Example:

yozxoskd

quantity

number

The quantity of this product. Must be at least 0.01. Must not be greater than 99999999.99.

Example:

unit

string

The unit of this product.

Must be one of:

pieces
weight

Example:

pieces

description

string

The description of this product. Must not be greater than 255 characters.

Example:

Table

Response Fields

uuid

string

The uuid of this product

quantity

number

The quantity of this product

description

string

The description of this product

unit

string

enum(pieces|weight) The unit of this product

identifier

string|null

Auth

Bearer

Headers

URL Parameters

Body

{ "identifier": "yozxoskd", "quantity": 20, "unit": "pieces", "description": "Table" }

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/tasks/8759f1ee-2376-38f4-b523-5d5244ccfb44/products/e76bfa24-eafd-3209-b66c-f12c6c54c484" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"identifier\": \"yozxoskd\",
    \"quantity\": 20,
    \"unit\": \"pieces\",
    \"description\": \"Table\"
}"

Example response:

{
    "data": {
        "uuid": "9f83bd30-0368-4973-a038-304ca913b87b",
        "quantity": "1.00",
        "description": "Test line",
        "unit": "pieces",
        "identifier": "2f7e673aae64ffbe3821016e253b45ed"
    }
}

DELETE Product

DELETE

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/products/{product_uuid}

requires authentication

Delete a product of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

676ba0ea-1fa1-3881-a05f-eec5de460ff5

product_uuid

string

uuid of the corresponding product

Example:

bd1a4386-42f3-34c2-9fa2-e31f2fcc6d80

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/tasks/676ba0ea-1fa1-3881-a05f-eec5de460ff5/products/bd1a4386-42f3-34c2-9fa2-e31f2fcc6d80" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[Empty response]

DELETE Products

DELETE

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/products

requires authentication

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

7da0b40f-ec03-30c8-9137-32d392d75852

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/tasks/7da0b40f-ec03-30c8-9137-32d392d75852/products" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[Empty response]

Task Codes

Task Codes are the bar/qr codes that are being scanned in a task.

GET Task Codes

GET

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/codes

requires authentication

Get collection of codes of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

5cc6596c-71c2-3aa3-899f-c9671fece0ed

Response Fields

data

object[]

Collection of codes

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/tasks/5cc6596c-71c2-3aa3-899f-c9671fece0ed/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f83bd30-048f-4840-913e-fcdeff4dd5ae",
            "amount": 1,
            "code": "qDwpoMl8K0LrmozT",
            "description": "box"
        }
    ]
}

POST Task Codes

POST

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/codes

requires authentication

Create a or multiple codes of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

f7a221f3-457a-30cb-acef-e41c5efda594

Body Parameters

data

object[]

Response Fields

data

object[]

Collection of codes

Auth

Bearer

Headers

URL Parameters

Body

{ "data": [ { "amount": 9, "code": "ulhjkecstymcfwbqkn", "description": "Table" } ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/tasks/f7a221f3-457a-30cb-acef-e41c5efda594/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": [
        {
            \"amount\": 9,
            \"code\": \"ulhjkecstymcfwbqkn\",
            \"description\": \"Table\"
        }
    ]
}"

Example response:

{
    "data": [
        {
            "uuid": "9f83bd32-31c2-4d3a-a6a2-a6baacb4bc4f",
            "amount": 1,
            "code": "1234567890",
            "description": "Box"
        },
        {
            "uuid": "9f83bd32-32b2-4d19-b010-6dba6f687b22",
            "amount": 2,
            "code": "ABCDEFGHIJ",
            "description": "Table"
        }
    ]
}

GET Task Code

GET

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/codes/{taskCode_uuid}

requires authentication

Get a code of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

80753f2a-de5a-3640-897f-ee5ddeb10a60

taskCode_uuid

string

uuid of the corresponding task code

Example:

b65f4697-b5e1-3a03-89d2-330ab77a854b

Response Fields

uuid

string

The uuid of this code

amount

integer

The amount of times this code needs to be scanned

code

string

The code that is needed to be scanned

description

string

The description of this code

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/tasks/80753f2a-de5a-3640-897f-ee5ddeb10a60/codes/b65f4697-b5e1-3a03-89d2-330ab77a854b" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f83bd30-048f-4840-913e-fcdeff4dd5ae",
        "amount": 1,
        "code": "qDwpoMl8K0LrmozT",
        "description": "box"
    }
}

PUT/PATCH Task Code

PUT

PATCH

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/codes/{taskCode_uuid}

requires authentication

Update a code of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

c4e47c55-b0bc-364c-8c4c-dbe97000a023

taskCode_uuid

string

uuid of the corresponding task code

Example:

44a642bc-9b28-3892-b889-58ff06a504bf

Body Parameters

amount

integer

The amount of times this code needs to be scanned. Must be at least 1. Must not be greater than 100.

Example:

code

string

The code that is needed to be scanned. Must not be greater than 255 characters.

Example:

yalaxacezztcretscaho

description

string

The description of this code. Must not be greater than 255 characters.

Example:

Table

Response Fields

uuid

string

The uuid of this code

amount

integer

The amount of times this code needs to be scanned

code

string

The code that is needed to be scanned

description

string

The description of this code

Auth

Bearer

Headers

URL Parameters

Body

{ "amount": 18, "code": "yalaxacezztcretscaho", "description": "Table" }

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/tasks/c4e47c55-b0bc-364c-8c4c-dbe97000a023/codes/44a642bc-9b28-3892-b889-58ff06a504bf" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"amount\": 18,
    \"code\": \"yalaxacezztcretscaho\",
    \"description\": \"Table\"
}"

Example response:

{
    "data": {
        "uuid": "9f83bd30-048f-4840-913e-fcdeff4dd5ae",
        "amount": 1,
        "code": "qDwpoMl8K0LrmozT",
        "description": "box"
    }
}

DELETE Task Code

DELETE

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/codes/{taskCode_uuid}

requires authentication

Delete a code of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

1fda4247-f9c9-34c5-b6d8-8f1da42f23ce

taskCode_uuid

string

uuid of the corresponding task code

Example:

cd0a351a-ae95-380a-9d79-0dd7893e36fb

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/tasks/1fda4247-f9c9-34c5-b6d8-8f1da42f23ce/codes/cd0a351a-ae95-380a-9d79-0dd7893e36fb" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[Empty response]

Visit Codes

Visit Codes are the bar/qr codes that are being scanned in a visit. A visit is a delivery or pickup attempt for a specific task. Usually, the visit codes are only set when using recurring tasks.

GET Visit Codes

GET

https://api.routelogic.io

/api/v2/visits/{scheduleVisit_uuid}/codes

requires authentication

Get collection of codes of a visit

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

scheduleVisit_uuid

string

uuid of the corresponding scheduled visit

Example:

53272e33-1b79-3457-a9d5-417ae151ba56

Response Fields

data

object[]

Collection of codes

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/visits/53272e33-1b79-3457-a9d5-417ae151ba56/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f83bd30-11c7-4276-bc2e-fd509cca74ba",
            "amount": 1,
            "code": "oHs5jBo5KSLa7zHl",
            "description": "box"
        }
    ]
}

POST Visit Codes

POST

https://api.routelogic.io

/api/v2/visits/{scheduleVisit_uuid}/codes

requires authentication

Create a or multiple codes of a visit

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

scheduleVisit_uuid

string

uuid of the corresponding scheduled visit

Example:

51350bcd-dcef-3376-878d-043157bd7fbf

Body Parameters

data

object[]

Response Fields

data

object[]

Collection of codes

Auth

Bearer

Headers

URL Parameters

Body

{ "data": [ { "amount": 3, "code": "bigdb", "description": "Table" } ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/visits/51350bcd-dcef-3376-878d-043157bd7fbf/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": [
        {
            \"amount\": 3,
            \"code\": \"bigdb\",
            \"description\": \"Table\"
        }
    ]
}"

Example response:

{
    "data": [
        {
            "uuid": "9f83bd33-35ff-40d7-8e45-47674422a559",
            "amount": 1,
            "code": "1234567890",
            "description": "Box"
        },
        {
            "uuid": "9f83bd33-372d-467b-8b76-a6498dc2696b",
            "amount": 2,
            "code": "ABCDEFGHIJ",
            "description": "Table"
        }
    ]
}

GET Visit Code

GET

https://api.routelogic.io

/api/v2/visits/{scheduleVisit_uuid}/codes/{scheduleVisitCode_uuid}

requires authentication

Get a code of a visit

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

scheduleVisit_uuid

string

uuid of the corresponding scheduled visit

Example:

f900d65e-265e-3cbf-ad76-7a78b6d395af

scheduleVisitCode_uuid

string

uuid of the corresponding scheduled visit code

Example:

60505298-4aec-3b0c-84e3-89dfa9b2b43d

Response Fields

uuid

string

The uuid of this code

amount

integer

The amount of times this code needs to be scanned

code

string

The code that is needed to be scanned

description

string

The description of this code

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/visits/f900d65e-265e-3cbf-ad76-7a78b6d395af/codes/60505298-4aec-3b0c-84e3-89dfa9b2b43d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f83bd30-11c7-4276-bc2e-fd509cca74ba",
        "amount": 1,
        "code": "oHs5jBo5KSLa7zHl",
        "description": "box"
    }
}

PUT/PATCH Visit Code

PUT

PATCH

https://api.routelogic.io

/api/v2/visits/{scheduleVisit_uuid}/codes/{scheduleVisitCode_uuid}

requires authentication

Update a code of a visit

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

scheduleVisit_uuid

string

uuid of the corresponding scheduled visit

Example:

2f805916-4f9f-371e-85b0-096253e64eaf

scheduleVisitCode_uuid

string

uuid of the corresponding scheduled visit code

Example:

0b1469e9-538c-3f7f-be35-0b98f521144c

Body Parameters

amount

integer

The amount of times this code needs to be scanned. Must be at least 1. Must not be greater than 100.

Example:

code

string

The code that is needed to be scanned. Must not be greater than 255 characters.

Example:

kppdqxmmzwymwocoqxrafkoyh

description

string

The description of this code. Must not be greater than 255 characters.

Example:

Table

Response Fields

uuid

string

The uuid of this code

amount

integer

The amount of times this code needs to be scanned

code

string

The code that is needed to be scanned

description

string

The description of this code

Auth

Bearer

Headers

URL Parameters

Body

{ "amount": 23, "code": "kppdqxmmzwymwocoqxrafkoyh", "description": "Table" }

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/visits/2f805916-4f9f-371e-85b0-096253e64eaf/codes/0b1469e9-538c-3f7f-be35-0b98f521144c" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"amount\": 23,
    \"code\": \"kppdqxmmzwymwocoqxrafkoyh\",
    \"description\": \"Table\"
}"

Example response:

{
    "data": {
        "uuid": "9f83bd30-11c7-4276-bc2e-fd509cca74ba",
        "amount": 1,
        "code": "oHs5jBo5KSLa7zHl",
        "description": "box"
    }
}

DELETE Visit Code

DELETE

https://api.routelogic.io

/api/v2/visits/{scheduleVisit_uuid}/codes/{scheduleVisitCode_uuid}

requires authentication

Delete a code of a visit

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

scheduleVisit_uuid

string

uuid of the corresponding scheduled visit

Example:

78e2bb3b-bf15-3bf0-8cf3-ebd1635cfcde

scheduleVisitCode_uuid

string

uuid of the corresponding scheduled visit code

Example:

c16a79b3-2a29-3013-b8c8-fa412c33ddef

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/visits/78e2bb3b-bf15-3bf0-8cf3-ebd1635cfcde/codes/c16a79b3-2a29-3013-b8c8-fa412c33ddef" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[Empty response]

Task Returnable Packaging

Task Returnable Packaging are the default packaging items beeing expected to be delivered and picked up.

GET Task Returnable Packaging

GET

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/returnablePackaging

requires authentication

Get collection of returnable packaging of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

2cc8a5ef-b8ee-3130-88d3-1e16cb01e34f

Response Fields

data

object[]|null

Collection of Task returnable packaging

object

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/tasks/2cc8a5ef-b8ee-3130-88d3-1e16cb01e34f/returnablePackaging" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f83bd30-0636-4ecc-ae07-b74d0b98ddf5",
            "count": 1,
            "returnable_packaging_type": {
                "uuid": "9f83bd30-0599-45d0-a8cf-4cbe82b24e38",
                "type": "container"
            }
        }
    ]
}

POST Task Returnable Packaging

POST

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/returnablePackaging

requires authentication

Create a or multiple returnable packaging of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

ea35a568-e92a-3fc6-ae00-b919cb05724a

Body Parameters

data

object[]

Response Fields

data

object[]|null

Collection of Task returnable packaging

object

Auth

Bearer

Headers

URL Parameters

Body

{ "data": [ { "count": 24, "returnable_packaging_type_uuid": "c15eea28-d8b7-310c-8d3b-16aad3dfeec7" } ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/tasks/ea35a568-e92a-3fc6-ae00-b919cb05724a/returnablePackaging" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": [
        {
            \"count\": 24,
            \"returnable_packaging_type_uuid\": \"c15eea28-d8b7-310c-8d3b-16aad3dfeec7\"
        }
    ]
}"

Example response:

{
    "data": [
        {
            "uuid": "9f83bd32-6e17-44db-876a-bdf2390a66b2",
            "count": 1,
            "returnable_packaging_type": {
                "uuid": "9f83bd30-0599-45d0-a8cf-4cbe82b24e38",
                "type": "container"
            }
        },
        {
            "uuid": "9f83bd32-6f5b-4ddd-8c21-31df45dc48b5",
            "count": -2,
            "returnable_packaging_type": {
                "uuid": "9f83bd30-0599-45d0-a8cf-4cbe82b24e38",
                "type": "container"
            }
        }
    ]
}

GET Task Returnable Packaging

GET

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/returnablePackaging/{taskReturnablePackaging_uuid}

requires authentication

Get a returnable packaging of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

f0a84091-b70f-3dea-86c7-5156ae0f39b7

taskReturnablePackaging_uuid

string

uuid of the corresponding task returnable packaging

Example:

db454ab0-1049-34c0-99f0-4d04d480c504

Response Fields

uuid

string

The uuid of this task returnable packaging

count

integer

The amount of task returnable packaging pick-up(+) or deliver(-)

returnable_packaging_type

object

Returnable packaging type information

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/tasks/f0a84091-b70f-3dea-86c7-5156ae0f39b7/returnablePackaging/db454ab0-1049-34c0-99f0-4d04d480c504" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f83bd30-0636-4ecc-ae07-b74d0b98ddf5",
        "count": 1,
        "returnable_packaging_type": {
            "uuid": "9f83bd30-0599-45d0-a8cf-4cbe82b24e38",
            "type": "container"
        }
    }
}

PUT/PATCH Task Returnable Packaging

PUT

PATCH

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/returnablePackaging/{taskReturnablePackaging_uuid}

requires authentication

Update a returnable packaging of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

2b32cf83-6c81-3a57-8f23-e443617aee1e

taskReturnablePackaging_uuid

string

uuid of the corresponding task returnable packaging

Example:

4f3abcc4-9b9a-3e3e-86fd-0c4b7e3a1d4e

Body Parameters

count

integer

The amount of returnable packaging pick-up(+) or deliver(-). Must be at least -10000. Must not be greater than 10000.

Example:

code

string

Response Fields

uuid

string

The uuid of this task returnable packaging

count

integer

The amount of task returnable packaging pick-up(+) or deliver(-)

returnable_packaging_type

object

Returnable packaging type information

Auth

Bearer

Headers

URL Parameters

Body

{ "count": 13, "code": null }

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/tasks/2b32cf83-6c81-3a57-8f23-e443617aee1e/returnablePackaging/4f3abcc4-9b9a-3e3e-86fd-0c4b7e3a1d4e" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"count\": 13
}"

Example response:

{
    "data": {
        "uuid": "9f83bd30-0636-4ecc-ae07-b74d0b98ddf5",
        "count": 1,
        "returnable_packaging_type": {
            "uuid": "9f83bd30-0599-45d0-a8cf-4cbe82b24e38",
            "type": "container"
        }
    }
}

DELETE Task Returnable Packaging

DELETE

https://api.routelogic.io

/api/v2/tasks/{task_uuid}/returnablePackaging/{taskReturnablePackaging_uuid}

requires authentication

Delete a returnable packaging of a task

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

task_uuid

string

uuid of the corresponding task

Example:

050862df-52bc-363c-8d71-e247aaec823e

taskReturnablePackaging_uuid

string

uuid of the corresponding task returnable packaging

Example:

8e6ad3ea-2471-3981-8e1e-5c78fe36956f

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/tasks/050862df-52bc-363c-8d71-e247aaec823e/returnablePackaging/8e6ad3ea-2471-3981-8e1e-5c78fe36956f" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[Empty response]

Webhook Groups

Webhook groups are the configured webhooks between Routelogic and your applications.

GET Webhook Groups

GET

https://api.routelogic.io

/api/v2/webhookGroups

requires authentication

Get paginated collection of webhook groups from your company

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

filters

object

filters.limit

integer

Amount of items on each page. 24 by default. Must not be greater than 100. Must be at least 1.

Example:

filters.page

integer

Page number. 1 by default. Must be at least 1.

Example:

Response Fields

data

object[]

Collection of webhook events

object

POST Webhook Group

POST

https://api.routelogic.io

/api/v2/webhookGroups

requires authentication

Create a webhook group for your company.

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

name

string

required

The name of the webhook group.

Example:

webhook

description

string

The description of the webhook group.

Example:

Webhook for listening to when a task is created

webhook_url

string

required

The url the webhooks get send to. Must be a valid URL.

Example:

https://example.com/webhook

webhook_secret

string

Optional Bearer token that is required for the end point receiving the webhooks.

Example:

token

events

string[]

required

Must be one of:

task_created
task_updated
task_deleted
visit_status_updated
internal_note_created
schedule_calculated
sending_notifications

Example:

["task_updated"]

Response Fields

uuid

string

Webhook ID

name

string

The name of this webhook group

description

string

The description of this webhook group

webhook_url

string

The url where you receive your webhooks

events[]

string[]

enum(task_created|task_updated|task_deleted|visit_status_updated|internal_note_created) List of events to receive webhooks from

Auth

Bearer

Headers

Body

{ "name": "webhook", "description": "Webhook for listening to when a task is created", "webhook_url": "https:\/\/example.com\/webhook", "webhook_secret": "token", "events": [ "task_updated" ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/webhookGroups" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"webhook\",
    \"description\": \"Webhook for listening to when a task is created\",
    \"webhook_url\": \"https:\\/\\/example.com\\/webhook\",
    \"webhook_secret\": \"token\",
    \"events\": [
        \"task_updated\"
    ]
}"

Example response:

{
    "data": {
        "uuid": "9f83bd32-b339-457a-b2ba-aff523a479cf",
        "name": "Demo webhook group",
        "description": "send to my api",
        "webhook_url": "https://routelogic.io",
        "events": [
            "task_created",
            "task_updated"
        ]
    }
}

GET Webhook Group

GET

https://api.routelogic.io

/api/v2/webhookGroups/{webhookGroup_uuid}

requires authentication

Get a webhook group from your company

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

webhookGroup_uuid

string

uuid of the corresponding webhook group

Example:

ea360aa8-548c-3bb2-9bfe-9e32b8ef432d

Response Fields

uuid

string

Webhook ID

name

string

The name of this webhook group

description

string

The description of this webhook group

webhook_url

string

The url where you receive your webhooks

events[]

string[]

enum(task_created|task_updated|task_deleted|visit_status_updated|internal_note_created) List of events to receive webhooks from

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/webhookGroups/ea360aa8-548c-3bb2-9bfe-9e32b8ef432d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f83bd30-3479-49dd-b2b4-80f5c725a649",
        "name": "Webhook group 2",
        "description": "task webhook group 2",
        "webhook_url": "https://test.com/webhook/",
        "events": [
            "task_created"
        ]
    }
}

PUT/PATCH Webhook Group

PUT

PATCH

https://api.routelogic.io

/api/v2/webhookGroups/{webhookGroup_uuid}

requires authentication

Update a webhook group from your company

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

webhookGroup_uuid

string

uuid of the corresponding webhook group

Example:

dbf17dcd-3b2f-3cbf-9555-21e49a0c2c0a

Body Parameters

name

string

The name of the webhook group.

Example:

webhook

description

string

The description of the webhook group.

Example:

Webhook for listening to when a task is created

webhook_url

string

The url the webhooks get send to. Must be a valid URL.

Example:

https://example.com/webhook

webhook_secret

string

Optional Bearer token that is required for the end point receiving the webhooks.

Example:

token

events

string[]

required

Must be one of:

task_created
task_updated
task_deleted
visit_status_updated
internal_note_created
schedule_calculated
sending_notifications

Example:

["task_created"]

Response Fields

uuid

string

Webhook ID

name

string

The name of this webhook group

description

string

The description of this webhook group

webhook_url

string

The url where you receive your webhooks

events[]

string[]

enum(task_created|task_updated|task_deleted|visit_status_updated|internal_note_created) List of events to receive webhooks from

Auth

Bearer

Headers

URL Parameters

Body

{ "name": "webhook", "description": "Webhook for listening to when a task is created", "webhook_url": "https:\/\/example.com\/webhook", "webhook_secret": "token", "events": [ "task_created" ] }

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/webhookGroups/dbf17dcd-3b2f-3cbf-9555-21e49a0c2c0a" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"webhook\",
    \"description\": \"Webhook for listening to when a task is created\",
    \"webhook_url\": \"https:\\/\\/example.com\\/webhook\",
    \"webhook_secret\": \"token\",
    \"events\": [
        \"task_created\"
    ]
}"

Example response:

{
    "data": {
        "uuid": "9f83bd30-3479-49dd-b2b4-80f5c725a649",
        "name": "Webhook group 2",
        "description": "task webhook group 2",
        "webhook_url": "https://test.com/webhook/",
        "events": [
            "task_created"
        ]
    }
}

DELETE Webhook Group

DELETE

https://api.routelogic.io

/api/v2/webhookGroups/{webhookGroup_uuid}

requires authentication

Delete a webhook group from your company

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

webhookGroup_uuid

string

uuid of the corresponding webhook group

Example:

c406144b-4ea8-3709-bd35-ce872c1c5e95

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/webhookGroups/c406144b-4ea8-3709-bd35-ce872c1c5e95" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[Empty response]

Webhook Events

Webhooks are the events that are being sent to your system.

GET Webhooks

GET

https://api.routelogic.io

/api/v2/webhookEvents

requires authentication

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

filters

object

filters.status_failed

boolean

Filter by failed status (>= 400). False by default.

filters.limit

integer

Amount of items on each page. 24 by default. Must not be greater than 100. Must be at least 1.

Example:

filters.page

integer

Page number. 1 by default. Must be at least 1.

Example:

Response Fields

data

object[]

Collection of webhook events

object

uuid

string

Webhook event ID

webhook_url

string

Webhook URL

event_data

object

Webhook event data

response_status

integer

Webhook response status

created_at

string

Webhook event creation date

updated_at

string

Webhook event update date

Auth

Bearer

Headers

Query Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/webhookEvents?filters[status_failed]=&filters[limit]=59&filters[page]=84" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "d371d273-5089-4e1d-af7e-6762c5a2a3d9",
            "webhook_url": "https://test.com/webhook/",
            "event_data": {
                "data": {
                    "note": null,
                    "tags": [],
                    "type": "delivery",
                    "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
                    "end_time": "17:00:00",
                    "recurring": null,
                    "created_at": "2025-07-30T13:20:35.000000Z",
                    "start_time": "08:00:00",
                    "updated_at": "2025-07-30T13:20:35.000000Z",
                    "delivery_date": "2025-07-30",
                    "external_link": null,
                    "used_capacity": 0,
                    "shipment_steps": null,
                    "return_required": null,
                    "used_capacity_2": 0,
                    "used_capacity_3": 0,
                    "return_task_uuid": null,
                    "delivery_from_date": null,
                    "external_reference": null,
                    "signature_required": null,
                    "external_identifier": "JHtiqp",
                    "track_and_trace_link": "http://localhost/tr/ldfNe7h6Noos",
                    "pending_payment_amount": 0,
                    "delivery_duration_minutes": 0,
                    "notification_template_uuid": null
                },
                "type": "task_created",
                "timestamp": "2025-07-30T15:20:35+02:00"
            },
            "response_status": 200,
            "created_at": "2025-07-30T13:20:35.000000Z",
            "updated_at": "2025-07-30T13:20:35.000000Z"
        }
    ],
    "meta": {
        "current_page": 1,
        "from": 1,
        "last_page": 1,
        "per_page": 24,
        "to": 1,
        "total": 1,
        "next": null,
        "prev": null
    }
}

GET Webhook

GET

https://api.routelogic.io

/api/v2/webhookEvents/{webhookEvent_uuid}

requires authentication

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

webhookEvent_uuid

string

uuid of the corresponding webhook event

Example:

a002df06-3c4d-3a5b-bee0-4f77c9b17bf0

Response Fields

data

object

uuid

string

Webhook event ID

webhook_url

string

Webhook URL

event_data

object

Webhook event data

response_status

integer

Webhook response status

created_at

string

Webhook event creation date

updated_at

string

Webhook event update date

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/webhookEvents/a002df06-3c4d-3a5b-bee0-4f77c9b17bf0" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "d371d273-5089-4e1d-af7e-6762c5a2a3d9",
        "webhook_url": "https://test.com/webhook/",
        "event_data": {
            "data": {
                "note": null,
                "tags": [],
                "type": "delivery",
                "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
                "end_time": "17:00:00",
                "recurring": null,
                "created_at": "2025-07-30T13:20:35.000000Z",
                "start_time": "08:00:00",
                "updated_at": "2025-07-30T13:20:35.000000Z",
                "delivery_date": "2025-07-30",
                "external_link": null,
                "used_capacity": 0,
                "shipment_steps": null,
                "return_required": null,
                "used_capacity_2": 0,
                "used_capacity_3": 0,
                "return_task_uuid": null,
                "delivery_from_date": null,
                "external_reference": null,
                "signature_required": null,
                "external_identifier": "JHtiqp",
                "track_and_trace_link": "http://localhost/tr/ldfNe7h6Noos",
                "pending_payment_amount": 0,
                "delivery_duration_minutes": 0,
                "notification_template_uuid": null
            },
            "type": "task_created",
            "timestamp": "2025-07-30T15:20:35+02:00"
        },
        "response_status": 200,
        "created_at": "2025-07-30T13:20:35.000000Z",
        "updated_at": "2025-07-30T13:20:35.000000Z"
    }
}

POST Resend Webhook

POST

https://api.routelogic.io

/api/v2/webhookEvents/{webhookEvent_uuid}/resend

requires authentication

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

webhookEvent_uuid

string

uuid of the corresponding webhook event

Example:

0baed8b0-d397-3941-8f9c-455d0e3ef07b

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/webhookEvents/0baed8b0-d397-3941-8f9c-455d0e3ef07b/resend" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[Empty response]

POST Resend All Failed Webhooks

POST

https://api.routelogic.io

/api/v2/webhookEvents/resend-all-failed

requires authentication

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

Auth

Bearer

Headers

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/webhookEvents/resend-all-failed" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [],
    "meta": {
        "count": 0
    }
}

Templates

Templates are the predefined messages that are being sent to your customers.

GET Templates

GET

https://api.routelogic.io

/api/v2/templates

requires authentication

Get collection of templates

RateLimit (16/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

Response Fields

data

object[]

Collection of templates

object

Auth

Bearer

Headers

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/templates" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f83bd2f-c18b-48c0-932c-f573f52cb30e",
            "identifier": "RpcpW77AFY8RQBp5",
            "title": "Standaard e-mail en SMS notificatie voor bezorgen",
            "default": true,
            "default_pickup": false
        },
        {
            "uuid": "9f83bd2f-c4bb-4db6-9b64-8dbe7037ad42",
            "identifier": "CDWTaGsdXg75Ej9q",
            "title": "Standaard e-mail en SMS notificatie voor ophalen",
            "default": false,
            "default_pickup": true
        }
    ]
}

Returnable Packaging Types

Returnable packaging types are the types of packaging used in your company wich can be returned after delivery.

GET Returnable packaging types

GET

https://api.routelogic.io

/api/v2/returnablePackagingTypes

requires authentication

Get collection of returnable packaging types

RateLimit (16/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

Response Fields

data

object[]|null

Collection of Returnable packaging types

Auth

Bearer

Headers

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/returnablePackagingTypes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f83bd2f-d936-4955-9459-d9ec59f138c2",
            "type": "Pallet"
        },
        {
            "uuid": "9f83bd2f-d9d4-4a7a-9848-8c0d2ed392b2",
            "type": "Container"
        },
        {
            "uuid": "9f83bd2f-da7b-4931-b359-cbca6553e111",
            "type": "Crate"
        },
        {
            "uuid": "9f83bd30-0599-45d0-a8cf-4cbe82b24e38",
            "type": "container"
        },
        {
            "uuid": "9f83bd30-153f-446f-b826-fec185b24e40",
            "type": "pallets"
        }
    ]
}

Schedules

Schedules are the planned routes for your vehicles.

GET Schedules

GET

https://api.routelogic.io

/api/v2/schedules

requires authentication

Get paginated collection of schedules including vehicles and visits from your company

RateLimit (5/min)
If you like to receive schedule information quicker use webhooks read more here

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

Query Parameters

filters

object

filters.from_date

string

Find tasks on this date and later. Combine with to_date to select a specific day or a range. Must be a valid date in the format Y-m-d.

Example:

2025-07-30

filters.to_date

string

Find tasks on this date and earlier. Combine with from_date to select a specific day or a range. Must be a valid date in the format Y-m-d.

Example:

2025-07-30

filters.limit

integer

Amount of items on each page. 24 by default. Must not be greater than 24. Must be at least 1.

Example:

filters.page

integer

Must be at least 1.

Example:

Response Fields

data

object[]

Collection of schedules

object

uuid

string

The uuid of this schedule

date

string

The date this schedule will be completed

description

string|null

Name of this schedule

total_travel_time

float|null

The total travel time of all vehicles in minutes

total_distance

float|null

The total travel distance of all vehicles in meters

notifications_send

boolean

Whether the notifications have been sent or not

schedule_vehicles

object

data

object[]

Collection of vehicles used in this schedule

object

uuid

string

The uuid of this scheduled vehicle

start_time

string|null

The time which the vehicle should start driving

end_time

string|null

The time when the vehicle should be done

started_at

string|null

The time when the vehicle actually started

finished_at

string|null

The time when the vehicle actually was done

total_travel_time

float|null

The total travel time of this vehicle in minutes

total_distance

float|null

The total travel distance of this vehicle in meters

vehicle

object

Vehicle information

user

object|null

Driver information

visits

object

data

object[]

Collection of visits the scheduled vehicle needs to visit

object

uuid

string

The uuid of this visit

type

string

enum(start|end|task|break|charge) The type of visit

order_index

integer

Index on which order the visits should be visited

delivery_time

string

The time which this visit should be completed

eta_start

string

Start of the estimated arrival time window

eta_end

string

End of the estimated arrival time window

task_uuid

string|null

The related task to this visit

address

object|null

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country[]

object

Country information

country

object

scanned_codes

object[]|null

Collection of ScannedCodes

returnable_packaging

object[]|null

Collection of Returnable packaging

data

object

task

object|null

Task information

uuid

string

The uuid of this task

type

string

enum(delivery|pickup) The type of this task

external_identifier

string

Unique identifier like order number

external_reference

string|null

Reference for api connections

note

string|null

Internal note for the driver / note from customer on order for the driver

pending_payment_amount

number

Amount the customer needs to pay on delivery

external_link

string|null

Link visible on the track and trace page like a bill

track_and_trace_link

string

Link to the track and trace page

delivery_from_date

string|null

The earliest date the task is allowed to be completed

delivery_date

string

The date the task is supposed to be completed

start_time

string|null

The time window start time. Timezone: Europe/Amsterdam

end_time

string|null

The time window end time. Timezone: Europe/Amsterdam

delivery_duration_minutes

integer

The time needed on location to complete the task

return_required

boolean

Specifies if the task should also have a corresponding 'pickup' task

signature_required

boolean

If the customer is required to place a signature for this task

used_capacity_1

integer

The amount of capacity this task takes

used_capacity_2

integer

The amount of capacity this task takes

used_capacity_3

integer

The amount of capacity this task takes

created_at

string

Date and time when this task was created

updated_at

string

Date and time when this task was updated

tags[]

string[]

The identifier of a tag.

return_task_uuid

string|null

The uuid of a related return task if available

notification_template_uuid

string|null

The uuid of the related notification template,

address

object

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

customer

object|null

Customer information

files

object[]|null

Collection of Files

signature

string

The key of this file. Used for retrieving the file through the files endpoint.

GET Schedule

GET

https://api.routelogic.io

/api/v2/schedules/{schedule_uuid}

requires authentication

Get a single schedule by its uuid

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

schedule_uuid

string

required

string The UUID of the schedule

Example:

538885db-a8b5-3ac4-b7d1-3b2c1b7cf9c1

Response Fields

uuid

string

The uuid of this schedule

date

string

The date this schedule will be completed

description

string|null

Name of this schedule

total_travel_time

float|null

The total travel time of all vehicles in minutes

total_distance

float|null

The total travel distance of all vehicles in meters

notifications_send

boolean

Whether the notifications have been sent or not

schedule_vehicles

object

data

object[]

Collection of vehicles used in this schedule

object

uuid

string

The uuid of this scheduled vehicle

start_time

string|null

The time which the vehicle should start driving

end_time

string|null

The time when the vehicle should be done

started_at

string|null

The time when the vehicle actually started

finished_at

string|null

The time when the vehicle actually was done

total_travel_time

float|null

The total travel time of this vehicle in minutes

total_distance

float|null

The total travel distance of this vehicle in meters

vehicle

object

Vehicle information

user

object|null

Driver information

visits

object

data

object[]

Collection of visits the scheduled vehicle needs to visit

object

uuid

string

The uuid of this visit

type

string

enum(start|end|task|break|charge) The type of visit

order_index

integer

Index on which order the visits should be visited

delivery_time

string

The time which this visit should be completed

eta_start

string

Start of the estimated arrival time window

eta_end

string

End of the estimated arrival time window

task_uuid

string|null

The related task to this visit

address

object|null

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country[]

object

Country information

country

object

scanned_codes

object[]|null

Collection of ScannedCodes

returnable_packaging

object[]|null

Collection of Returnable packaging

data

object

task

object|null

Task information

uuid

string

The uuid of this task

type

string

enum(delivery|pickup) The type of this task

external_identifier

string

Unique identifier like order number

external_reference

string|null

Reference for api connections

note

string|null

Internal note for the driver / note from customer on order for the driver

pending_payment_amount

number

Amount the customer needs to pay on delivery

external_link

string|null

Link visible on the track and trace page like a bill

track_and_trace_link

string

Link to the track and trace page

delivery_from_date

string|null

The earliest date the task is allowed to be completed

delivery_date

string

The date the task is supposed to be completed

start_time

string|null

The time window start time. Timezone: Europe/Amsterdam

end_time

string|null

The time window end time. Timezone: Europe/Amsterdam

delivery_duration_minutes

integer

The time needed on location to complete the task

return_required

boolean

Specifies if the task should also have a corresponding 'pickup' task

signature_required

boolean

If the customer is required to place a signature for this task

used_capacity_1

integer

The amount of capacity this task takes

used_capacity_2

integer

The amount of capacity this task takes

used_capacity_3

integer

The amount of capacity this task takes

created_at

string

Date and time when this task was created

updated_at

string

Date and time when this task was updated

tags[]

string[]

The identifier of a tag.

return_task_uuid

string|null

The uuid of a related return task if available

notification_template_uuid

string|null

The uuid of the related notification template,

address

object

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

customer

object|null

Customer information

files

object[]|null

Collection of Files

signature

string

The key of this file. Used for retrieving the file through the files endpoint.

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/schedules/538885db-a8b5-3ac4-b7d1-3b2c1b7cf9c1" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "d50332d4-ca9b-4017-9b6b-07c6e1366688",
        "date": "2025-07-30",
        "description": "Example Schedule 1",
        "total_travel_time": 0,
        "total_distance": 0,
        "notifications_send": false,
        "schedule_vehicles": {
            "data": [
                {
                    "uuid": "9f83bd30-0750-4574-826d-0284d6ce91f6",
                    "start_time": "08:00:00",
                    "end_time": "10:00:00",
                    "started_at": "2025-07-30 08:03:00",
                    "finished_at": "2025-07-30 10:02:00",
                    "total_travel_time": 0,
                    "total_distance": 1850,
                    "vehicle": {
                        "uuid": "9f83bd2f-e249-48ea-bf94-7ee7d153ae1f",
                        "licence_plate": "K9FPhsxTg",
                        "description": "Van 1"
                    },
                    "user": {
                        "uuid": "9f83bd2f-ecb3-46df-b86c-e343fe0709b0",
                        "name": "Miss Alberta Howell",
                        "public_name": "Miss Alberta Howell"
                    },
                    "visits": {
                        "data": [
                            {
                                "uuid": "9f83bd30-0828-47b0-81ec-fed874c80ccf",
                                "type": "task",
                                "order_index": 0,
                                "delivery_time": "09:00:00",
                                "eta_start": "08:25",
                                "eta_end": "09:25",
                                "task": {
                                    "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
                                    "type": "delivery",
                                    "external_identifier": "RLuGyLuEKnzC",
                                    "external_reference": null,
                                    "note": null,
                                    "pending_payment_amount": 0,
                                    "external_link": null,
                                    "track_and_trace_link": "http://localhost/tr/ldfNe7h6Noos",
                                    "delivery_from_date": null,
                                    "delivery_date": "2025-07-30",
                                    "start_time": "08:00:00",
                                    "end_time": "17:00:00",
                                    "delivery_duration_minutes": 0,
                                    "recurring": null,
                                    "return_required": false,
                                    "signature_required": false,
                                    "used_capacity": 0,
                                    "used_capacity_2": 0,
                                    "used_capacity_3": 0,
                                    "updated_at": "2025-07-30T13:20:36.000000Z",
                                    "created_at": "2025-07-30T13:20:35.000000Z",
                                    "tags": [],
                                    "notification_template_uuid": null,
                                    "return_task_uuid": null,
                                    "address": {
                                        "street": "49453 McDermott Isle",
                                        "house_number": "93094",
                                        "house_number_extension": null,
                                        "postal_code": "17133-5980",
                                        "city": "Cristobalberg",
                                        "latitude": 5.4321,
                                        "longitude": 5.4321,
                                        "address_line": "49453 McDermott Isle 93094",
                                        "full_address_line": "49453 McDermott Isle 93094, 17133-5980, Cristobalberg",
                                        "country": {
                                            "iso_code": "NL",
                                            "description": "Nederland"
                                        }
                                    },
                                    "customer": {
                                        "name": "Jessie Daniel",
                                        "email": null,
                                        "phone_number": null
                                    },
                                    "shipment_steps": null
                                },
                                "schedule_date": "2025-07-29T22:00:00.000000Z",
                                "address": {
                                    "street": "49453 McDermott Isle",
                                    "house_number": "93094",
                                    "house_number_extension": null,
                                    "postal_code": "17133-5980",
                                    "city": "Cristobalberg",
                                    "latitude": 5.4321,
                                    "longitude": 5.4321,
                                    "address_line": "49453 McDermott Isle 93094",
                                    "full_address_line": "49453 McDermott Isle 93094, 17133-5980, Cristobalberg",
                                    "country": {
                                        "iso_code": "NL",
                                        "description": "Nederland"
                                    }
                                },
                                "scanned_codes": {
                                    "data": [
                                        {
                                            "type": "task_code",
                                            "code_uuid": "9f83bd30-048f-4840-913e-fcdeff4dd5ae",
                                            "scanned_count": 1
                                        },
                                        {
                                            "type": "schedule_visit_code",
                                            "code_uuid": "9f83bd30-11c7-4276-bc2e-fd509cca74ba",
                                            "scanned_count": 1
                                        }
                                    ]
                                },
                                "returnable_packaging": {
                                    "data": [
                                        {
                                            "uuid": "9f83bd30-1605-436b-8440-9d2ca5e24409",
                                            "count": -2,
                                            "returnable_packaging_type": {
                                                "uuid": "9f83bd30-153f-446f-b826-fec185b24e40",
                                                "type": "pallets"
                                            }
                                        }
                                    ]
                                },
                                "status": {
                                    "status_identifier": "delivered"
                                },
                                "signature": "OWY4M2JkMzAtMDgyOC00N2IwLTgxZWMtZmVkODc0YzgwY2Nm",
                                "files": {
                                    "data": [
                                        {
                                            "type": "image",
                                            "key": "Q21hYVk5MkxaTk5GZkNIcw"
                                        }
                                    ]
                                }
                            }
                        ]
                    }
                }
            ]
        }
    }
}

POST Send schedule notifications

POST

https://api.routelogic.io

/api/v2/schedules/{schedule_uuid}/send-notifications

requires authentication

Send the notifications to all the customers within a schedule.

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

schedule_uuid

string

required

Example:

d50332d4-ca9b-4017-9b6b-07c6e1366688

Body Parameters

types

string[]

On what channels do you want to send this message, don't select any if you only want to receive the webhook.

Must be one of:

email
sms

Example:

["sms"]

Auth

Bearer

Headers

URL Parameters

Body

{ "types": [ "sms" ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/schedules/d50332d4-ca9b-4017-9b6b-07c6e1366688/send-notifications" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"types\": [
        \"sms\"
    ]
}"

Example response:

[Empty response]

Beta Appointments

POST api/v2/beta/appointments/availability

POST

https://api.routelogic.io

/api/v2/beta/appointments/availability

Headers

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

data

object

latitude

number

required

The latitude of the task.

Example:

1362

longitude

number

required

The longitude of the task.

Example:

6636.4908217

tags

string[]

Must not be greater than 255 characters.

Example:

["wrigcje"]

delivery_duration_minutes

integer

required

The duration of the delivery in minutes. Must be at least 1. Must not be greater than 1440.

Example:

start_date

string

required

The start date to check for available timeslots. Must be a valid date in the format Y-m-d. Must be a date after or equal to today.

Example:

2056-02-16

end_date

string

required

The end date to check for available timeslots, must be after the start date. Can't be more than 7 days after the start date. Must be a valid date in the format Y-m-d. Must be a date after or equal to data.start_date.

Example:

2108-04-26

used_capacity

integer

Must be at least 0. Must not be greater than 10000.

Example:

used_capacity_2

integer

Must be at least 0. Must not be greater than 10000.

Example:

used_capacity_3

integer

Must be at least 0. Must not be greater than 10000.

Example:

type

string

required

Must be one of:

delivery
pickup

Example:

pickup

Headers

Body

{ "data": { "latitude": 1362, "longitude": 6636.4908217, "tags": [ "wrigcje" ], "delivery_duration_minutes": 5, "start_date": "2056-02-16", "end_date": "2108-04-26", "used_capacity": 4, "used_capacity_2": 22, "used_capacity_3": 13, "type": "pickup" } }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/beta/appointments/availability" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": {
        \"latitude\": 1362,
        \"longitude\": 6636.4908217,
        \"tags\": [
            \"wrigcje\"
        ],
        \"delivery_duration_minutes\": 5,
        \"start_date\": \"2056-02-16\",
        \"end_date\": \"2108-04-26\",
        \"used_capacity\": 4,
        \"used_capacity_2\": 22,
        \"used_capacity_3\": 13,
        \"type\": \"pickup\"
    }
}"

POST api/v2/beta/appointments

POST

https://api.routelogic.io

/api/v2/beta/appointments

Headers

Content-Type

Example:

application/json

Example:

application/json

Body Parameters

type

string

The type of this task: delivery or pickup.

Must be one of:

delivery
pickup

Example:

delivery

external_identifier

string

required

Unique identifier like order number. Must not be greater than 255 characters.

Example:

ORD-12345

external_reference

string

Reference for api connections. Must not be greater than 255 characters.

Example:

REF-6789

note

string

Internal note for the driver / note from customer on order for the driver. Must not be greater than 20000 characters.

Example:

Please deliver at the side door.

external_link

string

Link visible on the track and trace page like a bill. Must not be greater than 2048 characters.

Example:

https://example.com/

start_time

string

The time window start time. Format: H:i. Must be a valid date in the format H:i.

Example:

08:00

end_time

string

The time window end time. Must be after start_time. Format: H:i. Must be a valid date in the format H:i. Must be a date after start_time.

Example:

17:00

delivery_duration_minutes

integer

The time needed on location to complete the task (0-1440 minutes). Must be at least 0. Must not be greater than 1440.

Example:

signature_required

boolean

If the customer is required to place a signature for this task.

used_capacity

number

The amount of capacity this task takes (up to 99999999.99 with max 2 decimal places). Must be at least 0. Must not be greater than 99999999.99.

Example:

10.5

used_capacity_2

number

The second capacity measurement for this task (up to 99999999.99 with max 2 decimal places). Must be at least 0. Must not be greater than 99999999.99.

Example:

5.25

used_capacity_3

number

The third capacity measurement for this task (up to 99999999.99 with max 2 decimal places). Must be at least 0. Must not be greater than 99999999.99.

Example:

2.75

notification_template_uuid

string

The uuid of the related notification template, requires NOTIFICATIONS feature. Must be a valid UUID.

Example:

123e4567-e89b-12d3-a456-426614174000

customer

string

required

Customer information.

tags

string[]

The identifier of a tag (max 250 characters). This field is required when tags is present. Must not be greater than 250 characters.

Example:

["cooled"]

appointment_date

string

required

The date of the appointment. Must be a valid date.

Example:

2023-12-31

address

object

required

Address information.

house_number

string

The house number. Must not be greater than 255 characters.

Example:

house_number_extension

string

Extra information about the house number. Must not be greater than 255 characters.

Example:

street

string

The street name (required unless latitude and longitude are provided). This field is required when address.latitude or address.longitude is not present. Must not be greater than 255 characters.

Example:

LongStreet

postal_code

string

The postal code (required unless latitude and longitude are provided). This field is required when address.latitude or address.longitude is not present. Must not be greater than 255 characters.

Example:

1234AB

city

string

The city (required unless latitude and longitude are provided). This field is required when address.latitude or address.longitude is not present. Must not be greater than 255 characters.

Example:

Amsterdam

country

string

required

The iso code of the country. The iso_code of an existing record in the countries table.

Example:

latitude

number

The latitude of the address (required with longitude if street/city/postal_code not provided). This field is required when address.city, address.street, or address.postal_code is not present. This field is required when address.longitude is present. Must be at least -90. Must not be greater than 90.

Example:

52.3675734

longitude

number

The longitude of the address (required with latitude if street/city/postal_code not provided). This field is required when address.city, address.street, or address.postal_code is not present. This field is required when address.latitude is present. Must be at least -180. Must not be greater than 180.

Example:

4.9041389

Headers

Body

{ "type": "delivery", "external_identifier": "ORD-12345", "external_reference": "REF-6789", "note": "Please deliver at the side door.", "external_link": "https:\/\/example.com\/", "start_time": "08:00", "end_time": "17:00", "delivery_duration_minutes": 30, "signature_required": false, "used_capacity": 10.5, "used_capacity_2": 5.25, "used_capacity_3": 2.75, "notification_template_uuid": "123e4567-e89b-12d3-a456-426614174000", "customer": { "name": "Andrew Smith", "email": "[email protected]", "phone_number": "+01 234567890" }, "tags": [ "cooled" ], "appointment_date": "2023-12-31", "address": { "house_number": "12", "house_number_extension": "1A", "street": "LongStreet", "postal_code": "1234AB", "city": "Amsterdam", "country": "NL", "latitude": 52.3675734, "longitude": 4.9041389 } }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/beta/appointments" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"type\": \"delivery\",
    \"external_identifier\": \"ORD-12345\",
    \"external_reference\": \"REF-6789\",
    \"note\": \"Please deliver at the side door.\",
    \"external_link\": \"https:\\/\\/example.com\\/\",
    \"start_time\": \"08:00\",
    \"end_time\": \"17:00\",
    \"delivery_duration_minutes\": 30,
    \"signature_required\": false,
    \"used_capacity\": 10.5,
    \"used_capacity_2\": 5.25,
    \"used_capacity_3\": 2.75,
    \"notification_template_uuid\": \"123e4567-e89b-12d3-a456-426614174000\",
    \"customer\": \"at\",
    \"tags\": [
        \"cooled\"
    ],
    \"appointment_date\": \"2023-12-31\",
    \"address\": {
        \"house_number\": \"12\",
        \"house_number_extension\": \"1A\",
        \"street\": \"LongStreet\",
        \"postal_code\": \"1234AB\",
        \"city\": \"Amsterdam\",
        \"country\": \"NL\",
        \"latitude\": 52.3675734,
        \"longitude\": 4.9041389
    }
}"

Files

Files are photo's and signature's from a visit

GET File

GET

https://api.routelogic.io

/api/v2/file/{key}

requires authentication

Get the image of a photo or a signature by key

RateLimit (60/min)

Headers

Authorization

Example:

Bearer {YOUR_API_KEY}

Content-Type

Example:

application/json

Example:

application/json

URL Parameters

key

string

required

The key of the related image

Example:

Y2DAi383qkBcm

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/file/Y2DAi383qkBcm" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

[Binary data] -  The image

Examples

Examples of how to use the API

How to generate an order pick list

It is possible to generate an order pick list for all routes on a specific date. This can be done by sending a GET request to the api/v2/schedules endpoint with the filters.date as a query parameter. The response will show you all the tasks for a specific date in order per vehicle.

How to sync my cms with routelogic (webhooks)

It is possible to sync your CMS with RouteLogic by using webhooks. You can create a webhook in the RouteLogic dashboard that will send a POST request to your CMS every time a task is created, updated or deleted. This way you can keep your CMS up to date with the latest information from RouteLogic. It is possible to set a bearer token for each webhook to make sure that only authorized requests are accepted by your CMS.

Moreover, you van also use the visit_status_updated webhook to get notified when the status of a visit is updated. The internal_note_created webhook can be used to get notified when an internal note is created by a driver.

How to work with barcodes / QR codes

To be able to scan barcodes or QR codes, they have to be linked to a task or visit in RouteLogic. In most cases a code should be linked to a task. This can be done by sending a POST request to the api/v2/tasks/{task_uuid}/codes endpoint with the barcode as a payload. Sometimes a package with the same code should be scanned multiple times. This can be done by adding the amount parameter to the payload.

It is possible to scan a code when delivering an order with the RouteLogic Driver App. The scanned codes will be visible in the manager portal and the scanned codes are also visible in a task endpoint.

Codes and recurring tasks

A recurring task is a task that is repeated on a regular basis. To create a recurring task, you add a recurring object to the payload of the POST request to the api/v2/tasks endpoint. If you want the same code for each delivery, you send a POST request to the api/v2/tasks/{task_uuid}/codes endpoint with the code as a payload. But if you want the code for just a specific delivery, you can add the code to the payload of the POST request to the api/v2/visits/{scheduleVisit_uuid}/codes endpoint. This will make sure that the code is only linked to that specific delivery and not to future deliveries.

Sending Notifications from Your Own Application

You can send notifications directly from your own application. To ensure this also works with the "Send Notifications" button in the Routelogic interface and to keep Routelogic aware of the notification status we recommend following this flow:

Enable Self-Managed Notifications Go to Notifications > Manage notifications yourself and make sure this setting is turned on.
Set Up the sending_notifications Webhook Configure the sending_notifications webhook. When this webhook is triggered, handle the messages in your application as needed.
Automate Notification Sending (Optional) If you want to automate notifications (without user interaction), do not send the notifications directly from your application. Instead, use the API endpoint: /api/v2/schedules/{schedule_uuid}/send-notifications This approach ensures Routelogic is aware of the notification status and triggers the webhook so you can process the messages accordingly.

Returnable Packaging

We don’t keep track of how many total returnable packaging items (like pallets or crates) are at a customer’s location. However, we do give you the tools to track this yourself using your own system. One way to do this is by using our schedule endpoint: /api/v2/schedules/{schedule_uuid} together with the visit_status_updated webhook. This includes returnable_packaging data per visit, showing how many items (like pallets) were delivered or picked up. Drivers can record these amounts in the app, so you can keep track of them through the API. Within the applications settings you can setup packaging types. To match these in your own system you can retrieve them with the /api/v2/returnablePackagingTypes endpoint.

Webhooks

This document describes the webhooks that are send by RouteLogic Webhooks are used to notify external systems about events that happen in the system. The webhooks are send to the provided webhook URL in the webhook group. The webhook URL can be set in the company synchronisation settings. It is possible to set multiple webhook URLs and only send specific events.

task_created

This event is sent when a task has been created

{
    "type": "task_created",
    "timestamp": "2025-07-30T15:20:37+02:00",
    "data": {
        "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
        "type": "delivery",
        "external_identifier": "JHtiqp",
        "external_reference": null,
        "note": null,
        "pending_payment_amount": 0,
        "external_link": null,
        "track_and_trace_link": "http:\/\/localhost\/tr\/ldfNe7h6Noos",
        "delivery_from_date": null,
        "delivery_date": "2025-07-30",
        "start_time": "08:00:00",
        "end_time": "17:00:00",
        "delivery_duration_minutes": 0,
        "recurring": null,
        "return_required": null,
        "signature_required": null,
        "used_capacity": 0,
        "used_capacity_2": 0,
        "used_capacity_3": 0,
        "updated_at": "2025-07-30T13:20:35.000000Z",
        "created_at": "2025-07-30T13:20:35.000000Z",
        "tags": [],
        "notification_template_uuid": null,
        "return_task_uuid": null,
        "shipment_steps": null
    }
}

task_updated

This event is sent when a task has been updated

{
    "type": "task_updated",
    "timestamp": "2025-07-30T15:20:37+02:00",
    "data": {
        "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
        "type": "delivery",
        "external_identifier": "JHtiqp",
        "external_reference": null,
        "note": null,
        "pending_payment_amount": 0,
        "external_link": null,
        "track_and_trace_link": "http:\/\/localhost\/tr\/ldfNe7h6Noos",
        "delivery_from_date": null,
        "delivery_date": "2025-07-30",
        "start_time": "08:00:00",
        "end_time": "17:00:00",
        "delivery_duration_minutes": 0,
        "recurring": null,
        "return_required": null,
        "signature_required": null,
        "used_capacity": 0,
        "used_capacity_2": 0,
        "used_capacity_3": 0,
        "updated_at": "2025-07-30T13:20:35.000000Z",
        "created_at": "2025-07-30T13:20:35.000000Z",
        "tags": [],
        "notification_template_uuid": null,
        "return_task_uuid": null,
        "shipment_steps": null
    }
}

task_deleted

This event is sent when a task has been deleted

{
    "type": "task_deleted",
    "timestamp": "2025-07-30T15:20:37+02:00",
    "data": {
        "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
        "type": "delivery",
        "external_identifier": "JHtiqp",
        "external_reference": null,
        "note": null,
        "pending_payment_amount": 0,
        "external_link": null,
        "track_and_trace_link": "http:\/\/localhost\/tr\/ldfNe7h6Noos",
        "delivery_from_date": null,
        "delivery_date": "2025-07-30",
        "start_time": "08:00:00",
        "end_time": "17:00:00",
        "delivery_duration_minutes": 0,
        "recurring": null,
        "return_required": null,
        "signature_required": null,
        "used_capacity": 0,
        "used_capacity_2": 0,
        "used_capacity_3": 0,
        "updated_at": "2025-07-30T13:20:35.000000Z",
        "created_at": "2025-07-30T13:20:35.000000Z",
        "tags": [],
        "notification_template_uuid": null,
        "return_task_uuid": null,
        "shipment_steps": null
    }
}

visit_status_updated

This event is sent when a visit status has been updated

{
    "type": "visit_status_updated",
    "timestamp": "2025-07-30T15:20:37+02:00",
    "data": {
        "uuid": "9f83bd30-0828-47b0-81ec-fed874c80ccf",
        "type": "task",
        "order_index": 0,
        "delivery_time": "09:00:00",
        "eta_start": "08:25",
        "eta_end": "09:25",
        "task": {
            "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
            "type": "delivery",
            "external_identifier": "JHtiqp",
            "external_reference": null,
            "note": null,
            "pending_payment_amount": 0,
            "external_link": null,
            "track_and_trace_link": "http:\/\/localhost\/tr\/ldfNe7h6Noos",
            "delivery_from_date": null,
            "delivery_date": "2025-07-30",
            "start_time": "08:00:00",
            "end_time": "17:00:00",
            "delivery_duration_minutes": 0,
            "recurring": null,
            "return_required": false,
            "signature_required": false,
            "used_capacity": 0,
            "used_capacity_2": 0,
            "used_capacity_3": 0,
            "updated_at": "2025-07-30T13:20:35.000000Z",
            "created_at": "2025-07-30T13:20:35.000000Z",
            "tags": [],
            "notification_template_uuid": null,
            "return_task_uuid": null,
            "address": {
                "street": "49453 McDermott Isle",
                "house_number": "93094",
                "house_number_extension": null,
                "postal_code": "17133-5980",
                "city": "Cristobalberg",
                "latitude": 5.4321,
                "longitude": 5.4321,
                "address_line": "49453 McDermott Isle 93094",
                "full_address_line": "49453 McDermott Isle 93094, 17133-5980, Cristobalberg",
                "country": {
                    "iso_code": "NL",
                    "description": "Nederland"
                }
            },
            "customer": {
                "name": "Jessie Daniel",
                "email": null,
                "phone_number": null
            },
            "shipment_steps": null
        },
        "schedule_date": "2025-07-29T22:00:00.000000Z",
        "status": {
            "status_identifier": "delivered"
        },
        "signature": "OWY4M2JkMzAtMDgyOC00N2IwLTgxZWMtZmVkODc0YzgwY2Nm",
        "files": {
            "data": [
                {
                    "type": "image",
                    "key": "Q21hYVk5MkxaTk5GZkNIcw"
                }
            ]
        },
        "schedule_uuid": "d50332d4-ca9b-4017-9b6b-07c6e1366688"
    }
}

internal_note_created

This event is send when an internal note has been created

{
    "type": "internal_note_created",
    "timestamp": "2025-07-30T15:20:37+02:00",
    "data": {
        "message": "This is an example message. Drivers use this to communicate with their managers",
        "visit": {
            "uuid": "9f83bd30-0828-47b0-81ec-fed874c80ccf",
            "type": "task",
            "order_index": 0,
            "delivery_time": "09:00:00",
            "eta_start": "08:25",
            "eta_end": "09:25",
            "task": {
                "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
                "type": "delivery",
                "external_identifier": "RLuGyLuEKnzC",
                "external_reference": null,
                "note": null,
                "pending_payment_amount": 0,
                "external_link": null,
                "track_and_trace_link": "http:\/\/localhost\/tr\/ldfNe7h6Noos",
                "delivery_from_date": null,
                "delivery_date": "2025-07-30",
                "start_time": "08:00:00",
                "end_time": "17:00:00",
                "delivery_duration_minutes": 0,
                "recurring": null,
                "return_required": false,
                "signature_required": false,
                "used_capacity": 0,
                "used_capacity_2": 0,
                "used_capacity_3": 0,
                "updated_at": "2025-07-30T13:20:36.000000Z",
                "created_at": "2025-07-30T13:20:35.000000Z",
                "tags": [],
                "notification_template_uuid": null,
                "return_task_uuid": null,
                "address": {
                    "street": "49453 McDermott Isle",
                    "house_number": "93094",
                    "house_number_extension": null,
                    "postal_code": "17133-5980",
                    "city": "Cristobalberg",
                    "latitude": 5.4321,
                    "longitude": 5.4321,
                    "address_line": "49453 McDermott Isle 93094",
                    "full_address_line": "49453 McDermott Isle 93094, 17133-5980, Cristobalberg",
                    "country": {
                        "iso_code": "NL",
                        "description": "Nederland"
                    }
                },
                "customer": {
                    "name": "Jessie Daniel",
                    "email": null,
                    "phone_number": null
                },
                "shipment_steps": null
            },
            "schedule_date": "2025-07-29T22:00:00.000000Z",
            "status": {
                "status_identifier": "delivered"
            },
            "signature": "OWY4M2JkMzAtMDgyOC00N2IwLTgxZWMtZmVkODc0YzgwY2Nm",
            "files": {
                "data": [
                    {
                        "type": "image",
                        "key": "Q21hYVk5MkxaTk5GZkNIcw"
                    }
                ]
            }
        }
    }
}

schedule_calculated

This event is sent everytime a schedule has been calculated

{
    "type": "schedule_calculated",
    "timestamp": "2025-07-30T15:20:37+02:00",
    "data": {
        "uuid": "d50332d4-ca9b-4017-9b6b-07c6e1366688",
        "date": "2025-07-30",
        "description": "Example Schedule 1",
        "total_travel_time": 0,
        "total_distance": 0,
        "notifications_send": false,
        "schedule_vehicles": {
            "data": [
                {
                    "uuid": "9f83bd30-0750-4574-826d-0284d6ce91f6",
                    "start_time": "08:00:00",
                    "end_time": "10:00:00",
                    "started_at": "2025-07-30 08:03:00",
                    "finished_at": "2025-07-30 10:02:00",
                    "total_travel_time": 0,
                    "total_distance": 1850,
                    "vehicle": {
                        "uuid": "9f83bd2f-e249-48ea-bf94-7ee7d153ae1f",
                        "licence_plate": "K9FPhsxTg",
                        "description": "Van 1"
                    },
                    "visits": {
                        "data": [
                            {
                                "uuid": "9f83bd30-0828-47b0-81ec-fed874c80ccf",
                                "type": "task",
                                "order_index": 0,
                                "delivery_time": "09:00:00",
                                "task": {
                                    "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
                                    "external_identifier": "RLuGyLuEKnzC"
                                },
                                "task_uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
                                "schedule_date": "2025-07-29T22:00:00.000000Z",
                                "status": {
                                    "status_identifier": "delivered"
                                },
                                "signature": "OWY4M2JkMzAtMDgyOC00N2IwLTgxZWMtZmVkODc0YzgwY2Nm",
                                "files": {
                                    "data": [
                                        {
                                            "type": "image",
                                            "key": "Q21hYVk5MkxaTk5GZkNIcw"
                                        }
                                    ]
                                }
                            }
                        ]
                    }
                }
            ]
        }
    }
}

sending_notifications

This event is sent everytime the notifications are being send through the button in the application or the api.

{
    "type": "sending_notifications",
    "timestamp": "2025-07-30T15:20:38+02:00",
    "data": {
        "uuid": "d50332d4-ca9b-4017-9b6b-07c6e1366688",
        "date": "2025-07-30",
        "description": "Example Schedule 1",
        "total_travel_time": 0,
        "total_distance": 0,
        "notifications_send": false,
        "first_notification": true,
        "schedule_vehicles": {
            "data": [
                {
                    "uuid": "9f83bd30-0750-4574-826d-0284d6ce91f6",
                    "start_time": "08:00:00",
                    "end_time": "10:00:00",
                    "started_at": "2025-07-30 08:03:00",
                    "finished_at": "2025-07-30 10:02:00",
                    "total_travel_time": 0,
                    "total_distance": 1850,
                    "vehicle": {
                        "uuid": "9f83bd2f-e249-48ea-bf94-7ee7d153ae1f",
                        "licence_plate": "K9FPhsxTg",
                        "description": "Van 1"
                    },
                    "user": {
                        "uuid": "9f83bd2f-ecb3-46df-b86c-e343fe0709b0",
                        "name": "Miss Alberta Howell",
                        "public_name": "Miss Alberta Howell"
                    },
                    "visits": {
                        "data": [
                            {
                                "uuid": "9f83bd30-0828-47b0-81ec-fed874c80ccf",
                                "type": "task",
                                "order_index": 0,
                                "delivery_time": "09:00:00",
                                "eta_start": "08:25",
                                "eta_end": "09:25",
                                "task": {
                                    "uuid": "9f83bd2f-f19c-4c31-b4a6-b095004d60d3",
                                    "type": "delivery",
                                    "external_identifier": "RLuGyLuEKnzC",
                                    "external_reference": null,
                                    "note": null,
                                    "pending_payment_amount": 0,
                                    "external_link": null,
                                    "track_and_trace_link": "http:\/\/localhost\/tr\/ldfNe7h6Noos",
                                    "delivery_from_date": null,
                                    "delivery_date": "2025-07-30",
                                    "start_time": "08:00:00",
                                    "end_time": "17:00:00",
                                    "delivery_duration_minutes": 0,
                                    "recurring": null,
                                    "return_required": false,
                                    "signature_required": false,
                                    "used_capacity": 0,
                                    "used_capacity_2": 0,
                                    "used_capacity_3": 0,
                                    "updated_at": "2025-07-30T13:20:36.000000Z",
                                    "created_at": "2025-07-30T13:20:35.000000Z",
                                    "tags": [],
                                    "notification_template_uuid": null,
                                    "return_task_uuid": null,
                                    "address": {
                                        "street": "49453 McDermott Isle",
                                        "house_number": "93094",
                                        "house_number_extension": null,
                                        "postal_code": "17133-5980",
                                        "city": "Cristobalberg",
                                        "latitude": 5.4321,
                                        "longitude": 5.4321,
                                        "address_line": "49453 McDermott Isle 93094",
                                        "full_address_line": "49453 McDermott Isle 93094, 17133-5980, Cristobalberg",
                                        "country": {
                                            "iso_code": "NL",
                                            "description": "Nederland"
                                        }
                                    },
                                    "customer": {
                                        "name": "Jessie Daniel",
                                        "email": null,
                                        "phone_number": null
                                    },
                                    "shipment_steps": null
                                },
                                "schedule_date": "2025-07-29T22:00:00.000000Z",
                                "status": {
                                    "status_identifier": "delivered"
                                },
                                "signature": "OWY4M2JkMzAtMDgyOC00N2IwLTgxZWMtZmVkODc0YzgwY2Nm"
                            }
                        ]
                    }
                }
            ]
        }
    }
}