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-06-25

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-06-25

filters.types

string[]

Filter on specific task types.

Must be one of:

delivery
pickup
recurring

Example:

["delivery"]

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:

include

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) 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

files

object[]|null

Collection of Files

signature

string

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

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

Example:

delivery

external_identifier

string

required

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

Example:

external_reference

string

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

Example:

kfwcmzwriqrrd

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:

2020-07-25

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:

fed71d3c-c0a7-3e04-8161-f1bc5047de81

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:

83ecd585-48e2-3b88-9d0c-8c51887f9cb2

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:

2068-11-14

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:

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:

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-06-25T11:57:14

Response Fields

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. 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

country

object

Country information

{float}

address[].longitude float The longitude of the address

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

files

object[]|null

Collection of Files

data

object

Auth

Bearer

Headers

Body

{ "type": "delivery", "external_identifier": "nf", "external_reference": "kfwcmzwriqrrd", "note": "Please deliver at the side door.", "pending_payment_amount": 100, "external_link": "https:\/\/example.com\/", "delivery_from_date": "2020-07-25", "start_time": "08:00", "end_time": "17:00", "delivery_duration_minutes": 15, "return_required": false, "return_task_uuid": "fed71d3c-c0a7-3e04-8161-f1bc5047de81", "signature_required": true, "used_capacity": 21, "used_capacity_2": 5, "used_capacity_3": 7, "notification_template_uuid": "83ecd585-48e2-3b88-9d0c-8c51887f9cb2", "recurring": { "period": "month", "interval": 15, "settings": "[\"string\", \"third\", \"monday\"]", "end_date": "2068-11-14" }, "address": { "house_number": "12", "house_number_extension": "1A", "street": "LongStreet", "postal_code": "1234AB", "city": "Amsterdam", "country": "NL", "latitude": 23, "longitude": 18 }, "customer": { "email": "[email protected]", "phone_number": "+01 234567890", "name": "Andrew" }, "tags": [ "cooled" ], "delivery_date": "2025-06-25T11:57:14" }

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\": \"nf\",
    \"external_reference\": \"kfwcmzwriqrrd\",
    \"note\": \"Please deliver at the side door.\",
    \"pending_payment_amount\": 100,
    \"external_link\": \"https:\\/\\/example.com\\/\",
    \"delivery_from_date\": \"2020-07-25\",
    \"start_time\": \"08:00\",
    \"end_time\": \"17:00\",
    \"delivery_duration_minutes\": 15,
    \"return_required\": false,
    \"return_task_uuid\": \"fed71d3c-c0a7-3e04-8161-f1bc5047de81\",
    \"signature_required\": true,
    \"used_capacity\": 21,
    \"used_capacity_2\": 5,
    \"used_capacity_3\": 7,
    \"notification_template_uuid\": \"83ecd585-48e2-3b88-9d0c-8c51887f9cb2\",
    \"recurring\": {
        \"period\": \"month\",
        \"interval\": 15,
        \"settings\": \"[\\\"string\\\", \\\"third\\\", \\\"monday\\\"]\",
        \"end_date\": \"2068-11-14\"
    },
    \"address\": {
        \"house_number\": \"12\",
        \"house_number_extension\": \"1A\",
        \"street\": \"LongStreet\",
        \"postal_code\": \"1234AB\",
        \"city\": \"Amsterdam\",
        \"country\": \"NL\",
        \"latitude\": 23,
        \"longitude\": 18
    },
    \"customer\": {
        \"email\": \"[email protected]\",
        \"phone_number\": \"+01 234567890\",
        \"name\": \"Andrew\"
    },
    \"tags\": [
        \"cooled\"
    ],
    \"delivery_date\": \"2025-06-25T11:57:14\"
}"

$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' => 'nf',
            'external_reference' => 'kfwcmzwriqrrd',
            'note' => 'Please deliver at the side door.',
            'pending_payment_amount' => 100.0,
            'external_link' => 'https://example.com/',
            'delivery_from_date' => '2020-07-25',
            'start_time' => '08:00',
            'end_time' => '17:00',
            'delivery_duration_minutes' => 15,
            'return_required' => false,
            'return_task_uuid' => 'fed71d3c-c0a7-3e04-8161-f1bc5047de81',
            'signature_required' => true,
            'used_capacity' => 21,
            'used_capacity_2' => 5,
            'used_capacity_3' => 7,
            'notification_template_uuid' => '83ecd585-48e2-3b88-9d0c-8c51887f9cb2',
            'recurring' => [
                'period' => 'month',
                'interval' => 15,
                'settings' => '["string", "third", "monday"]',
                'end_date' => '2068-11-14',
            ],
            'address' => [
                'house_number' => '12',
                'house_number_extension' => '1A',
                'street' => 'LongStreet',
                'postal_code' => '1234AB',
                'city' => 'Amsterdam',
                'country' => 'NL',
                'latitude' => 23,
                'longitude' => 18,
            ],
            'customer' => [
                'email' => '[email protected]',
                'phone_number' => '+01 234567890',
                'name' => 'Andrew',
            ],
            'tags' => [
                'cooled',
            ],
            'delivery_date' => '2025-06-25T11:57:14',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response:

{
    "uuid": "9f3d0c03-21c2-4a3c-9027-d914d43f934b",
    "type": "delivery",
    "external_identifier": "RL1DbnENbRUp",
    "external_reference": null,
    "note": null,
    "pending_payment_amount": 0,
    "external_link": null,
    "track_and_trace_link": "http://localhost/tr/GeSMdIumrtfS",
    "delivery_from_date": null,
    "delivery_date": "2025-06-25",
    "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-06-25T09:57:13.000000Z",
    "created_at": "2025-06-25T09:57:13.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
    },
    "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:

c9b1e0c1-90d0-3a84-9350-5035c044982a

Response Fields

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. 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

country

object

Country information

{float}

address[].longitude float The longitude of the address

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

files

object[]|null

Collection of Files

data

object

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/tasks/c9b1e0c1-90d0-3a84-9350-5035c044982a" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
    "type": "delivery",
    "external_identifier": "OCjooc",
    "external_reference": null,
    "note": null,
    "pending_payment_amount": 0,
    "external_link": null,
    "track_and_trace_link": "http://localhost/tr/jmQJQGCr0GvW",
    "delivery_from_date": null,
    "delivery_date": "2025-06-25",
    "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-06-25T09:57:12.000000Z",
    "created_at": "2025-06-25T09:57:12.000000Z",
    "tags": [],
    "notification_template_uuid": null,
    "return_task_uuid": null,
    "address": {
        "street": "7721 Jacobs Rapids",
        "house_number": "3608",
        "house_number_extension": null,
        "postal_code": "17217",
        "city": "Lake Linwood",
        "latitude": 5.4321,
        "longitude": 5.4321,
        "address_line": "7721 Jacobs Rapids 3608",
        "full_address_line": "7721 Jacobs Rapids 3608, 17217, Lake Linwood",
        "country": {
            "iso_code": "NL",
            "description": "Nederland"
        }
    },
    "customer": {
        "name": "Alexander Spencer",
        "email": null,
        "phone_number": null
    },
    "next_visit": {
        "uuid": "9f3d0c01-dcb0-4992-b6d0-7c25e4f1bcac",
        "type": "task",
        "order_index": 0,
        "delivery_time": "09:00:00",
        "schedule_date": "2025-06-24T22:00:00.000000Z",
        "address": {
            "street": "7721 Jacobs Rapids",
            "house_number": "3608",
            "house_number_extension": null,
            "postal_code": "17217",
            "city": "Lake Linwood",
            "latitude": 5.4321,
            "longitude": 5.4321,
            "address_line": "7721 Jacobs Rapids 3608",
            "full_address_line": "7721 Jacobs Rapids 3608, 17217, Lake Linwood",
            "country": {
                "iso_code": "NL",
                "description": "Nederland"
            }
        },
        "scanned_codes": {
            "data": [
                {
                    "type": "task_code",
                    "code_uuid": "9f3d0c01-d875-413e-9904-4ee920d6cb2c",
                    "scanned_count": 1
                },
                {
                    "type": "schedule_visit_code",
                    "code_uuid": "9f3d0c01-e741-436b-b289-7bb99d21a624",
                    "scanned_count": 1
                }
            ]
        },
        "status": {
            "status_identifier": "delivered"
        },
        "signature": "OWYzZDBjMDEtZGNiMC00OTkyLWI2ZDAtN2MyNWU0ZjFiY2Fj",
        "files": {
            "data": [
                {
                    "type": "image",
                    "key": "OVRuRjBzZ05jVmM3bWVybQ"
                }
            ]
        }
    }
}

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:

0db67aaa-f505-31d7-8cf9-3be05ba41ba1

Body Parameters

type

string

The type of this task.

Must be one of:

delivery
pickup

Example:

pickup

external_identifier

string

required

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

Example:

ubckbxoddqnemnnjvbnwa

external_reference

string

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

Example:

fxuszspcbppzuxo

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:

2010-09-20

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:

192548c9-7d28-3cda-a37f-554ab1f2da25

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. 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:

406f8026-444b-3004-8782-f536f3fc5d13

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.

. 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:

2114-06-12

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:

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:

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-06-25T11:57:14

Response Fields

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. 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

country

object

Country information

{float}

address[].longitude float The longitude of the address

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

files

object[]|null

Collection of Files

data

object

Auth

Bearer

Headers

URL Parameters

Body

{ "type": "pickup", "external_identifier": "ubckbxoddqnemnnjvbnwa", "external_reference": "fxuszspcbppzuxo", "note": "Please deliver at the side door.", "pending_payment_amount": 100, "external_link": "https:\/\/example.com\/", "delivery_from_date": "2010-09-20", "start_time": "08:00", "end_time": "17:00", "delivery_duration_minutes": 24, "return_required": false, "return_task_uuid": "192548c9-7d28-3cda-a37f-554ab1f2da25", "signature_required": false, "used_capacity": 1, "used_capacity_2": 11, "used_capacity_3": 22, "notification_template_uuid": "406f8026-444b-3004-8782-f536f3fc5d13", "recurring": { "period": "month", "interval": 10, "settings": "[\"string\", \"third\", \"monday\"]", "end_date": "2114-06-12" }, "address": { "house_number": "12", "house_number_extension": "1A", "street": "LongStreet", "postal_code": "1234AB", "city": "Amsterdam", "country": "NL", "latitude": 3, "longitude": 21 }, "customer": { "email": "[email protected]", "phone_number": "+01 234567890", "name": "Andrew" }, "tags": [ "cooled" ], "delivery_date": "2025-06-25T11:57:14" }

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/tasks/0db67aaa-f505-31d7-8cf9-3be05ba41ba1" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"type\": \"pickup\",
    \"external_identifier\": \"ubckbxoddqnemnnjvbnwa\",
    \"external_reference\": \"fxuszspcbppzuxo\",
    \"note\": \"Please deliver at the side door.\",
    \"pending_payment_amount\": 100,
    \"external_link\": \"https:\\/\\/example.com\\/\",
    \"delivery_from_date\": \"2010-09-20\",
    \"start_time\": \"08:00\",
    \"end_time\": \"17:00\",
    \"delivery_duration_minutes\": 24,
    \"return_required\": false,
    \"return_task_uuid\": \"192548c9-7d28-3cda-a37f-554ab1f2da25\",
    \"signature_required\": false,
    \"used_capacity\": 1,
    \"used_capacity_2\": 11,
    \"used_capacity_3\": 22,
    \"notification_template_uuid\": \"406f8026-444b-3004-8782-f536f3fc5d13\",
    \"recurring\": {
        \"period\": \"month\",
        \"interval\": 10,
        \"settings\": \"[\\\"string\\\", \\\"third\\\", \\\"monday\\\"]\",
        \"end_date\": \"2114-06-12\"
    },
    \"address\": {
        \"house_number\": \"12\",
        \"house_number_extension\": \"1A\",
        \"street\": \"LongStreet\",
        \"postal_code\": \"1234AB\",
        \"city\": \"Amsterdam\",
        \"country\": \"NL\",
        \"latitude\": 3,
        \"longitude\": 21
    },
    \"customer\": {
        \"email\": \"[email protected]\",
        \"phone_number\": \"+01 234567890\",
        \"name\": \"Andrew\"
    },
    \"tags\": [
        \"cooled\"
    ],
    \"delivery_date\": \"2025-06-25T11:57:14\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://api.routelogic.io/api/v2/tasks/0db67aaa-f505-31d7-8cf9-3be05ba41ba1';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_API_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'type' => 'pickup',
            'external_identifier' => 'ubckbxoddqnemnnjvbnwa',
            'external_reference' => 'fxuszspcbppzuxo',
            'note' => 'Please deliver at the side door.',
            'pending_payment_amount' => 100.0,
            'external_link' => 'https://example.com/',
            'delivery_from_date' => '2010-09-20',
            'start_time' => '08:00',
            'end_time' => '17:00',
            'delivery_duration_minutes' => 24,
            'return_required' => false,
            'return_task_uuid' => '192548c9-7d28-3cda-a37f-554ab1f2da25',
            'signature_required' => false,
            'used_capacity' => 1,
            'used_capacity_2' => 11,
            'used_capacity_3' => 22,
            'notification_template_uuid' => '406f8026-444b-3004-8782-f536f3fc5d13',
            'recurring' => [
                'period' => 'month',
                'interval' => 10,
                'settings' => '["string", "third", "monday"]',
                'end_date' => '2114-06-12',
            ],
            'address' => [
                'house_number' => '12',
                'house_number_extension' => '1A',
                'street' => 'LongStreet',
                'postal_code' => '1234AB',
                'city' => 'Amsterdam',
                'country' => 'NL',
                'latitude' => 3,
                'longitude' => 21,
            ],
            'customer' => [
                'email' => '[email protected]',
                'phone_number' => '+01 234567890',
                'name' => 'Andrew',
            ],
            'tags' => [
                'cooled',
            ],
            'delivery_date' => '2025-06-25T11:57:14',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response:

{
    "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
    "type": "delivery",
    "external_identifier": "RLMpYYCBfKZb",
    "external_reference": null,
    "note": null,
    "pending_payment_amount": 0,
    "external_link": null,
    "track_and_trace_link": "http://localhost/tr/jmQJQGCr0GvW",
    "delivery_from_date": null,
    "delivery_date": "2025-06-25",
    "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-06-25T09:57:13.000000Z",
    "created_at": "2025-06-25T09:57:12.000000Z",
    "tags": [],
    "notification_template_uuid": null,
    "return_task_uuid": null,
    "address": {
        "street": "7721 Jacobs Rapids",
        "house_number": "3608",
        "house_number_extension": null,
        "postal_code": "17217",
        "city": "Lake Linwood",
        "latitude": 5.4321,
        "longitude": 5.4321,
        "address_line": "7721 Jacobs Rapids 3608",
        "full_address_line": "7721 Jacobs Rapids 3608, 17217, Lake Linwood",
        "country": {
            "iso_code": "NL",
            "description": "Nederland"
        }
    },
    "customer": {
        "name": "Alexander Spencer",
        "email": null,
        "phone_number": null
    },
    "next_visit": {
        "uuid": "9f3d0c01-dcb0-4992-b6d0-7c25e4f1bcac",
        "type": "task",
        "order_index": 0,
        "delivery_time": "09:00:00",
        "schedule_date": "2025-06-24T22:00:00.000000Z",
        "address": {
            "street": "7721 Jacobs Rapids",
            "house_number": "3608",
            "house_number_extension": null,
            "postal_code": "17217",
            "city": "Lake Linwood",
            "latitude": 5.4321,
            "longitude": 5.4321,
            "address_line": "7721 Jacobs Rapids 3608",
            "full_address_line": "7721 Jacobs Rapids 3608, 17217, Lake Linwood",
            "country": {
                "iso_code": "NL",
                "description": "Nederland"
            }
        },
        "scanned_codes": {
            "data": [
                {
                    "type": "task_code",
                    "code_uuid": "9f3d0c01-d875-413e-9904-4ee920d6cb2c",
                    "scanned_count": 1
                },
                {
                    "type": "schedule_visit_code",
                    "code_uuid": "9f3d0c01-e741-436b-b289-7bb99d21a624",
                    "scanned_count": 1
                }
            ]
        },
        "status": {
            "status_identifier": "delivered"
        },
        "signature": "OWYzZDBjMDEtZGNiMC00OTkyLWI2ZDAtN2MyNWU0ZjFiY2Fj",
        "files": {
            "data": [
                {
                    "type": "image",
                    "key": "OVRuRjBzZ05jVmM3bWVybQ"
                }
            ]
        }
    }
}

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:

034cf443-1085-3663-a138-ef75b4713448

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/034cf443-1085-3663-a138-ef75b4713448?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:

fbc14201-f11b-3e37-855c-d982e9bf477b

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/fbc14201-f11b-3e37-855c-d982e9bf477b/products" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f3d0c01-d646-41bc-9eb6-e5d6ef2e4c1b",
            "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:

45acb6b2-8b5a-357e-b756-60daf2c59e43

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:

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

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": "yj", "quantity": 24, "unit": "pieces", "description": "Table" } ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/tasks/45acb6b2-8b5a-357e-b756-60daf2c59e43/products" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": [
        {
            \"identifier\": \"yj\",
            \"quantity\": 24,
            \"unit\": \"pieces\",
            \"description\": \"Table\"
        }
    ]
}"

Example response:

{
    "data": [
        {
            "uuid": "9f3d0c03-c071-49f0-a61f-01ffb684b210",
            "quantity": 1,
            "description": "Test line",
            "unit": "pieces",
            "identifier": "2f7e673aae64ffbe3821016e253b45ed"
        },
        {
            "uuid": "9f3d0c03-c11f-4e9c-a83f-a8d01b6196c0",
            "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:

99a04d00-1c4b-3ce1-b15c-2b2a11de1c79

product_uuid

string

uuid of the corresponding product

Example:

e6a8b9e5-b6a0-30e4-9b90-bf3dba6b9d5e

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/99a04d00-1c4b-3ce1-b15c-2b2a11de1c79/products/e6a8b9e5-b6a0-30e4-9b90-bf3dba6b9d5e" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f3d0c01-d646-41bc-9eb6-e5d6ef2e4c1b",
        "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:

23c2f8ce-a252-36af-9b6e-7da46f07e9c0

product_uuid

string

uuid of the corresponding product

Example:

a24d3999-13bf-37be-a890-d5e5abff1003

Body Parameters

identifier

string

Example:

fwbxmvohcmy

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

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": "fwbxmvohcmy", "quantity": 6, "unit": "weight", "description": "Table" }

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/tasks/23c2f8ce-a252-36af-9b6e-7da46f07e9c0/products/a24d3999-13bf-37be-a890-d5e5abff1003" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"identifier\": \"fwbxmvohcmy\",
    \"quantity\": 6,
    \"unit\": \"weight\",
    \"description\": \"Table\"
}"

Example response:

{
    "data": {
        "uuid": "9f3d0c01-d646-41bc-9eb6-e5d6ef2e4c1b",
        "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:

af010a64-3786-3de2-a30a-8c347a7b72f2

product_uuid

string

uuid of the corresponding product

Example:

48c894ce-dfdd-3504-9507-419e95ef959f

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/tasks/af010a64-3786-3de2-a30a-8c347a7b72f2/products/48c894ce-dfdd-3504-9507-419e95ef959f" \
    --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:

90207ca8-4a74-3303-a037-4edca1a95699

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/tasks/90207ca8-4a74-3303-a037-4edca1a95699/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:

1d882663-4bc7-3ca9-bc43-744a49bf6ec9

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/1d882663-4bc7-3ca9-bc43-744a49bf6ec9/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f3d0c01-d875-413e-9904-4ee920d6cb2c",
            "amount": 1,
            "code": "3Dn0b95cj6vd0xf3",
            "description": "table"
        }
    ]
}

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:

d9f349dd-e1cd-32b1-8b78-b76909a1053b

Body Parameters

data

object[]

Response Fields

data

object[]

Collection of codes

Auth

Bearer

Headers

URL Parameters

Body

{ "data": [ { "amount": 12, "code": "gmedcjgdhwvnevdxlbpk", "description": "Table" } ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/tasks/d9f349dd-e1cd-32b1-8b78-b76909a1053b/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": [
        {
            \"amount\": 12,
            \"code\": \"gmedcjgdhwvnevdxlbpk\",
            \"description\": \"Table\"
        }
    ]
}"

Example response:

{
    "data": [
        {
            "uuid": "9f3d0c03-ef87-4f3f-9646-c23e6ac6d217",
            "amount": 1,
            "code": "1234567890",
            "description": "Box"
        },
        {
            "uuid": "9f3d0c03-f09a-4967-925c-db58b9ce3563",
            "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:

60736a6a-db79-3a71-9b19-f191969db33c

taskCode_uuid

string

uuid of the corresponding task code

Example:

3ef89b3a-95c8-357e-8a02-ae868d679e8e

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/60736a6a-db79-3a71-9b19-f191969db33c/codes/3ef89b3a-95c8-357e-8a02-ae868d679e8e" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f3d0c01-d875-413e-9904-4ee920d6cb2c",
        "amount": 1,
        "code": "3Dn0b95cj6vd0xf3",
        "description": "table"
    }
}

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:

9048d6c4-6525-3f0d-a11a-ebf72d5bd293

taskCode_uuid

string

uuid of the corresponding task code

Example:

12c4b4d6-0a91-38f1-8bcb-7cb72d58d7c1

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:

honknpugxjo

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": 13, "code": "honknpugxjo", "description": "Table" }

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/tasks/9048d6c4-6525-3f0d-a11a-ebf72d5bd293/codes/12c4b4d6-0a91-38f1-8bcb-7cb72d58d7c1" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"amount\": 13,
    \"code\": \"honknpugxjo\",
    \"description\": \"Table\"
}"

Example response:

{
    "data": {
        "uuid": "9f3d0c01-d875-413e-9904-4ee920d6cb2c",
        "amount": 1,
        "code": "3Dn0b95cj6vd0xf3",
        "description": "table"
    }
}

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:

554f2668-405d-3cc6-836a-cc655cb94d40

taskCode_uuid

string

uuid of the corresponding task code

Example:

f978dd55-d019-3958-be7a-df8dc2d255c0

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/tasks/554f2668-405d-3cc6-836a-cc655cb94d40/codes/f978dd55-d019-3958-be7a-df8dc2d255c0" \
    --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:

afc4e077-dc0f-3afc-8434-e511cd1a3ac3

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/afc4e077-dc0f-3afc-8434-e511cd1a3ac3/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f3d0c01-e741-436b-b289-7bb99d21a624",
            "amount": 1,
            "code": "c6rJTIlIMe2HIefn",
            "description": "lamp"
        }
    ]
}

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:

00d634a7-9759-30f5-a4ed-ce672344db54

Body Parameters

data

object[]

Response Fields

data

object[]

Collection of codes

Auth

Bearer

Headers

URL Parameters

Body

{ "data": [ { "amount": 17, "code": "goxzkolneqtcsrroaffwtwi", "description": "Table" } ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/visits/00d634a7-9759-30f5-a4ed-ce672344db54/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": [
        {
            \"amount\": 17,
            \"code\": \"goxzkolneqtcsrroaffwtwi\",
            \"description\": \"Table\"
        }
    ]
}"

Example response:

{
    "data": [
        {
            "uuid": "9f3d0c04-9bbc-42d9-a3a2-d8a22f663511",
            "amount": 1,
            "code": "1234567890",
            "description": "Box"
        },
        {
            "uuid": "9f3d0c04-9c65-44d8-aaa5-8911b69be474",
            "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:

f54ea857-56be-39e6-987e-95e27b753214

scheduleVisitCode_uuid

string

uuid of the corresponding scheduled visit code

Example:

080d6170-ef7e-3359-abbb-1d94af4445dd

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/f54ea857-56be-39e6-987e-95e27b753214/codes/080d6170-ef7e-3359-abbb-1d94af4445dd" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f3d0c01-e741-436b-b289-7bb99d21a624",
        "amount": 1,
        "code": "c6rJTIlIMe2HIefn",
        "description": "lamp"
    }
}

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:

8dda50d6-bc6f-3458-a31c-7983291a5450

scheduleVisitCode_uuid

string

uuid of the corresponding scheduled visit code

Example:

b4b6cf4f-2792-387c-8acc-bda2d9136d69

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:

zretixmhhn

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": 16, "code": "zretixmhhn", "description": "Table" }

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/visits/8dda50d6-bc6f-3458-a31c-7983291a5450/codes/b4b6cf4f-2792-387c-8acc-bda2d9136d69" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"amount\": 16,
    \"code\": \"zretixmhhn\",
    \"description\": \"Table\"
}"

Example response:

{
    "data": {
        "uuid": "9f3d0c01-e741-436b-b289-7bb99d21a624",
        "amount": 1,
        "code": "c6rJTIlIMe2HIefn",
        "description": "lamp"
    }
}

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:

14844d64-01db-3c4d-8d5d-99b2b9306396

scheduleVisitCode_uuid

string

uuid of the corresponding scheduled visit code

Example:

09f12ad1-c101-3d2e-b80f-d61ab0cd62f2

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/visits/14844d64-01db-3c4d-8d5d-99b2b9306396/codes/09f12ad1-c101-3d2e-b80f-d61ab0cd62f2" \
    --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:

["visit_status_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": [ "visit_status_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\": [
        \"visit_status_updated\"
    ]
}"

Example response:

{
    "data": {
        "uuid": "9f3d0c04-29a2-4b3e-90b0-4e912f2423de",
        "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:

5126846f-612c-3f7b-b038-62bf5efadfff

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/5126846f-612c-3f7b-b038-62bf5efadfff" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f3d0c02-046e-49e9-887d-c9f0663022d3",
        "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:

b49acb75-ee35-35f8-b587-f7dffb081e8f

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:

["sending_notifications"]

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

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/webhookGroups/b49acb75-ee35-35f8-b587-f7dffb081e8f" \
    --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\": [
        \"sending_notifications\"
    ]
}"

Example response:

{
    "data": {
        "uuid": "9f3d0c02-046e-49e9-887d-c9f0663022d3",
        "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:

276f0a66-5f24-3010-9c6d-6ea22354fb77

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/webhookGroups/276f0a66-5f24-3010-9c6d-6ea22354fb77" \
    --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]=25&filters[page]=65" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "306c8722-99c0-4e96-aefb-cb1d3f676fea",
            "webhook_url": "https://test.com/webhook/",
            "event_data": {
                "data": {
                    "note": null,
                    "tags": [],
                    "type": "delivery",
                    "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
                    "end_time": "17:00:00",
                    "recurring": null,
                    "created_at": "2025-06-25T09:57:12.000000Z",
                    "start_time": "08:00:00",
                    "updated_at": "2025-06-25T09:57:12.000000Z",
                    "delivery_date": "2025-06-25",
                    "external_link": null,
                    "used_capacity": 0,
                    "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": "OCjooc",
                    "track_and_trace_link": "http://localhost/tr/jmQJQGCr0GvW",
                    "pending_payment_amount": 0,
                    "delivery_duration_minutes": 0,
                    "notification_template_uuid": null
                },
                "type": "task_created",
                "timestamp": "2025-06-25T11:57:12+02:00"
            },
            "response_status": 200,
            "created_at": "2025-06-25T09:57:12.000000Z",
            "updated_at": "2025-06-25T09:57:12.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:

2f9fc7e3-3c04-3c7c-9e8a-76d889525e15

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/2f9fc7e3-3c04-3c7c-9e8a-76d889525e15" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "306c8722-99c0-4e96-aefb-cb1d3f676fea",
        "webhook_url": "https://test.com/webhook/",
        "event_data": {
            "data": {
                "note": null,
                "tags": [],
                "type": "delivery",
                "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
                "end_time": "17:00:00",
                "recurring": null,
                "created_at": "2025-06-25T09:57:12.000000Z",
                "start_time": "08:00:00",
                "updated_at": "2025-06-25T09:57:12.000000Z",
                "delivery_date": "2025-06-25",
                "external_link": null,
                "used_capacity": 0,
                "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": "OCjooc",
                "track_and_trace_link": "http://localhost/tr/jmQJQGCr0GvW",
                "pending_payment_amount": 0,
                "delivery_duration_minutes": 0,
                "notification_template_uuid": null
            },
            "type": "task_created",
            "timestamp": "2025-06-25T11:57:12+02:00"
        },
        "response_status": 200,
        "created_at": "2025-06-25T09:57:12.000000Z",
        "updated_at": "2025-06-25T09:57:12.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:

11a8b50e-1de3-3ea7-baa0-18f2b56601e1

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/webhookEvents/11a8b50e-1de3-3ea7-baa0-18f2b56601e1/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": "9f3d0c01-8cd0-4b93-803b-6ea4b28d3c81",
            "identifier": "0lMWhC3VfVcRdxHb",
            "title": "Standaard e-mail en SMS notificatie voor bezorgen",
            "default": true,
            "default_pickup": false
        },
        {
            "uuid": "9f3d0c01-9107-40cd-8baf-55f04125d69a",
            "identifier": "2DEV3mqdPiTJr6uR",
            "title": "Standaard e-mail en SMS notificatie voor ophalen",
            "default": false,
            "default_pickup": true
        }
    ]
}

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-06-25

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-06-25

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

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:

7428e252-f029-3607-a486-fa260226eda5

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

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/7428e252-f029-3607-a486-fa260226eda5" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "d95b3567-0af9-4e7f-aa79-d4b4003c84d2",
        "date": "2025-06-25",
        "description": "Example Schedule 1",
        "total_travel_time": 0,
        "total_distance": 0,
        "notifications_send": false,
        "schedule_vehicles": {
            "data": [
                {
                    "uuid": "9f3d0c01-db35-4ece-b722-353dbd30d1b4",
                    "start_time": "08:00:00",
                    "end_time": "10:00:00",
                    "started_at": "2025-06-25 08:03:00",
                    "finished_at": "2025-06-25 10:02:00",
                    "total_travel_time": 0,
                    "total_distance": 1850,
                    "vehicle": {
                        "uuid": "9f3d0c01-9fc0-4cdb-9a80-4f9fc4c14401",
                        "licence_plate": "CjyC6xh2F",
                        "description": "Van 1"
                    },
                    "user": {
                        "uuid": "9f3d0c01-a8b4-46c5-895b-a3be17741615",
                        "name": "Mr. Jett Stamm",
                        "public_name": "Mr. Jett Stamm"
                    },
                    "visits": {
                        "data": [
                            {
                                "uuid": "9f3d0c01-dcb0-4992-b6d0-7c25e4f1bcac",
                                "type": "task",
                                "order_index": 0,
                                "delivery_time": "09:00:00",
                                "eta_start": "08:25",
                                "eta_end": "09:25",
                                "task": {
                                    "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
                                    "type": "delivery",
                                    "external_identifier": "RLMpYYCBfKZb",
                                    "external_reference": null,
                                    "note": null,
                                    "pending_payment_amount": 0,
                                    "external_link": null,
                                    "track_and_trace_link": "http://localhost/tr/jmQJQGCr0GvW",
                                    "delivery_from_date": null,
                                    "delivery_date": "2025-06-25",
                                    "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-06-25T09:57:13.000000Z",
                                    "created_at": "2025-06-25T09:57:12.000000Z",
                                    "tags": [],
                                    "notification_template_uuid": null,
                                    "return_task_uuid": null,
                                    "address": {
                                        "street": "7721 Jacobs Rapids",
                                        "house_number": "3608",
                                        "house_number_extension": null,
                                        "postal_code": "17217",
                                        "city": "Lake Linwood",
                                        "latitude": 5.4321,
                                        "longitude": 5.4321,
                                        "address_line": "7721 Jacobs Rapids 3608",
                                        "full_address_line": "7721 Jacobs Rapids 3608, 17217, Lake Linwood",
                                        "country": {
                                            "iso_code": "NL",
                                            "description": "Nederland"
                                        }
                                    },
                                    "customer": {
                                        "name": "Alexander Spencer",
                                        "email": null,
                                        "phone_number": null
                                    }
                                },
                                "schedule_date": "2025-06-24T22:00:00.000000Z",
                                "address": {
                                    "street": "7721 Jacobs Rapids",
                                    "house_number": "3608",
                                    "house_number_extension": null,
                                    "postal_code": "17217",
                                    "city": "Lake Linwood",
                                    "latitude": 5.4321,
                                    "longitude": 5.4321,
                                    "address_line": "7721 Jacobs Rapids 3608",
                                    "full_address_line": "7721 Jacobs Rapids 3608, 17217, Lake Linwood",
                                    "country": {
                                        "iso_code": "NL",
                                        "description": "Nederland"
                                    }
                                },
                                "scanned_codes": {
                                    "data": [
                                        {
                                            "type": "task_code",
                                            "code_uuid": "9f3d0c01-d875-413e-9904-4ee920d6cb2c",
                                            "scanned_count": 1
                                        },
                                        {
                                            "type": "schedule_visit_code",
                                            "code_uuid": "9f3d0c01-e741-436b-b289-7bb99d21a624",
                                            "scanned_count": 1
                                        }
                                    ]
                                },
                                "status": {
                                    "status_identifier": "delivered"
                                },
                                "signature": "OWYzZDBjMDEtZGNiMC00OTkyLWI2ZDAtN2MyNWU0ZjFiY2Fj",
                                "files": {
                                    "data": [
                                        {
                                            "type": "image",
                                            "key": "OVRuRjBzZ05jVmM3bWVybQ"
                                        }
                                    ]
                                }
                            }
                        ]
                    }
                }
            ]
        }
    }
}

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:

d95b3567-0af9-4e7f-aa79-d4b4003c84d2

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:

["email"]

Auth

Bearer

Headers

URL Parameters

Body

{ "types": [ "email" ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/schedules/d95b3567-0af9-4e7f-aa79-d4b4003c84d2/send-notifications" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"types\": [
        \"email\"
    ]
}"

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:

24.15259

longitude

number

required

The longitude of the task.

Example:

7726601.89

tags

string[]

Must not be greater than 255 characters.

Example:

["tkzfzuhxezi"]

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:

2042-12-13

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:

2090-10-17

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": 24.15259, "longitude": 7726601.89, "tags": [ "tkzfzuhxezi" ], "delivery_duration_minutes": 5, "start_date": "2042-12-13", "end_date": "2090-10-17", "used_capacity": 10, "used_capacity_2": 11, "used_capacity_3": 4, "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\": 24.15259,
        \"longitude\": 7726601.89,
        \"tags\": [
            \"tkzfzuhxezi\"
        ],
        \"delivery_duration_minutes\": 5,
        \"start_date\": \"2042-12-13\",
        \"end_date\": \"2090-10-17\",
        \"used_capacity\": 10,
        \"used_capacity_2\": 11,
        \"used_capacity_3\": 4,
        \"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\": \"ut\",
    \"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.

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-06-25T11:57:14+02:00",
    "data": {
        "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
        "type": "delivery",
        "external_identifier": "OCjooc",
        "external_reference": null,
        "note": null,
        "pending_payment_amount": 0,
        "external_link": null,
        "track_and_trace_link": "http:\/\/localhost\/tr\/jmQJQGCr0GvW",
        "delivery_from_date": null,
        "delivery_date": "2025-06-25",
        "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-06-25T09:57:12.000000Z",
        "created_at": "2025-06-25T09:57:12.000000Z",
        "tags": [],
        "notification_template_uuid": null,
        "return_task_uuid": null
    }
}

task_updated

This event is sent when a task has been updated

{
    "type": "task_updated",
    "timestamp": "2025-06-25T11:57:14+02:00",
    "data": {
        "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
        "type": "delivery",
        "external_identifier": "OCjooc",
        "external_reference": null,
        "note": null,
        "pending_payment_amount": 0,
        "external_link": null,
        "track_and_trace_link": "http:\/\/localhost\/tr\/jmQJQGCr0GvW",
        "delivery_from_date": null,
        "delivery_date": "2025-06-25",
        "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-06-25T09:57:12.000000Z",
        "created_at": "2025-06-25T09:57:12.000000Z",
        "tags": [],
        "notification_template_uuid": null,
        "return_task_uuid": null
    }
}

task_deleted

This event is sent when a task has been deleted

{
    "type": "task_deleted",
    "timestamp": "2025-06-25T11:57:14+02:00",
    "data": {
        "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
        "type": "delivery",
        "external_identifier": "OCjooc",
        "external_reference": null,
        "note": null,
        "pending_payment_amount": 0,
        "external_link": null,
        "track_and_trace_link": "http:\/\/localhost\/tr\/jmQJQGCr0GvW",
        "delivery_from_date": null,
        "delivery_date": "2025-06-25",
        "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-06-25T09:57:12.000000Z",
        "created_at": "2025-06-25T09:57:12.000000Z",
        "tags": [],
        "notification_template_uuid": null,
        "return_task_uuid": null
    }
}

visit_status_updated

This event is sent when a visit status has been updated

{
    "type": "visit_status_updated",
    "timestamp": "2025-06-25T11:57:14+02:00",
    "data": {
        "uuid": "9f3d0c01-dcb0-4992-b6d0-7c25e4f1bcac",
        "type": "task",
        "order_index": 0,
        "delivery_time": "09:00:00",
        "eta_start": "08:25",
        "eta_end": "09:25",
        "task": {
            "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
            "type": "delivery",
            "external_identifier": "OCjooc",
            "external_reference": null,
            "note": null,
            "pending_payment_amount": 0,
            "external_link": null,
            "track_and_trace_link": "http:\/\/localhost\/tr\/jmQJQGCr0GvW",
            "delivery_from_date": null,
            "delivery_date": "2025-06-25",
            "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-06-25T09:57:12.000000Z",
            "created_at": "2025-06-25T09:57:12.000000Z",
            "tags": [],
            "notification_template_uuid": null,
            "return_task_uuid": null,
            "address": {
                "street": "7721 Jacobs Rapids",
                "house_number": "3608",
                "house_number_extension": null,
                "postal_code": "17217",
                "city": "Lake Linwood",
                "latitude": 5.4321,
                "longitude": 5.4321,
                "address_line": "7721 Jacobs Rapids 3608",
                "full_address_line": "7721 Jacobs Rapids 3608, 17217, Lake Linwood",
                "country": {
                    "iso_code": "NL",
                    "description": "Nederland"
                }
            },
            "customer": {
                "name": "Alexander Spencer",
                "email": null,
                "phone_number": null
            }
        },
        "schedule_date": "2025-06-24T22:00:00.000000Z",
        "status": {
            "status_identifier": "delivered"
        },
        "signature": "OWYzZDBjMDEtZGNiMC00OTkyLWI2ZDAtN2MyNWU0ZjFiY2Fj",
        "files": {
            "data": [
                {
                    "type": "image",
                    "key": "OVRuRjBzZ05jVmM3bWVybQ"
                }
            ]
        },
        "schedule_uuid": "d95b3567-0af9-4e7f-aa79-d4b4003c84d2"
    }
}

internal_note_created

This event is send when an internal note has been created

{
    "type": "internal_note_created",
    "timestamp": "2025-06-25T11:57:14+02:00",
    "data": {
        "message": "This is an example message. Drivers use this to communicate with their managers",
        "visit": {
            "uuid": "9f3d0c01-dcb0-4992-b6d0-7c25e4f1bcac",
            "type": "task",
            "order_index": 0,
            "delivery_time": "09:00:00",
            "eta_start": "08:25",
            "eta_end": "09:25",
            "task": {
                "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
                "type": "delivery",
                "external_identifier": "RLMpYYCBfKZb",
                "external_reference": null,
                "note": null,
                "pending_payment_amount": 0,
                "external_link": null,
                "track_and_trace_link": "http:\/\/localhost\/tr\/jmQJQGCr0GvW",
                "delivery_from_date": null,
                "delivery_date": "2025-06-25",
                "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-06-25T09:57:13.000000Z",
                "created_at": "2025-06-25T09:57:12.000000Z",
                "tags": [],
                "notification_template_uuid": null,
                "return_task_uuid": null,
                "address": {
                    "street": "7721 Jacobs Rapids",
                    "house_number": "3608",
                    "house_number_extension": null,
                    "postal_code": "17217",
                    "city": "Lake Linwood",
                    "latitude": 5.4321,
                    "longitude": 5.4321,
                    "address_line": "7721 Jacobs Rapids 3608",
                    "full_address_line": "7721 Jacobs Rapids 3608, 17217, Lake Linwood",
                    "country": {
                        "iso_code": "NL",
                        "description": "Nederland"
                    }
                },
                "customer": {
                    "name": "Alexander Spencer",
                    "email": null,
                    "phone_number": null
                }
            },
            "schedule_date": "2025-06-24T22:00:00.000000Z",
            "status": {
                "status_identifier": "delivered"
            },
            "signature": "OWYzZDBjMDEtZGNiMC00OTkyLWI2ZDAtN2MyNWU0ZjFiY2Fj",
            "files": {
                "data": [
                    {
                        "type": "image",
                        "key": "OVRuRjBzZ05jVmM3bWVybQ"
                    }
                ]
            }
        }
    }
}

schedule_calculated

This event is sent everytime a schedule has been calculated

{
    "type": "schedule_calculated",
    "timestamp": "2025-06-25T11:57:14+02:00",
    "data": {
        "uuid": "d95b3567-0af9-4e7f-aa79-d4b4003c84d2",
        "date": "2025-06-25",
        "description": "Example Schedule 1",
        "total_travel_time": 0,
        "total_distance": 0,
        "notifications_send": false,
        "schedule_vehicles": {
            "data": [
                {
                    "uuid": "9f3d0c01-db35-4ece-b722-353dbd30d1b4",
                    "start_time": "08:00:00",
                    "end_time": "10:00:00",
                    "started_at": "2025-06-25 08:03:00",
                    "finished_at": "2025-06-25 10:02:00",
                    "total_travel_time": 0,
                    "total_distance": 1850,
                    "vehicle": {
                        "uuid": "9f3d0c01-9fc0-4cdb-9a80-4f9fc4c14401",
                        "licence_plate": "CjyC6xh2F",
                        "description": "Van 1"
                    },
                    "visits": {
                        "data": [
                            {
                                "uuid": "9f3d0c01-dcb0-4992-b6d0-7c25e4f1bcac",
                                "type": "task",
                                "order_index": 0,
                                "delivery_time": "09:00:00",
                                "task": {
                                    "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
                                    "external_identifier": "RLMpYYCBfKZb"
                                },
                                "task_uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
                                "schedule_date": "2025-06-24T22:00:00.000000Z",
                                "status": {
                                    "status_identifier": "delivered"
                                },
                                "signature": "OWYzZDBjMDEtZGNiMC00OTkyLWI2ZDAtN2MyNWU0ZjFiY2Fj",
                                "files": {
                                    "data": [
                                        {
                                            "type": "image",
                                            "key": "OVRuRjBzZ05jVmM3bWVybQ"
                                        }
                                    ]
                                }
                            }
                        ]
                    }
                }
            ]
        }
    }
}

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-06-25T11:57:14+02:00",
    "data": {
        "uuid": "d95b3567-0af9-4e7f-aa79-d4b4003c84d2",
        "date": "2025-06-25",
        "description": "Example Schedule 1",
        "total_travel_time": 0,
        "total_distance": 0,
        "notifications_send": false,
        "first_notification": true,
        "schedule_vehicles": {
            "data": [
                {
                    "uuid": "9f3d0c01-db35-4ece-b722-353dbd30d1b4",
                    "start_time": "08:00:00",
                    "end_time": "10:00:00",
                    "started_at": "2025-06-25 08:03:00",
                    "finished_at": "2025-06-25 10:02:00",
                    "total_travel_time": 0,
                    "total_distance": 1850,
                    "vehicle": {
                        "uuid": "9f3d0c01-9fc0-4cdb-9a80-4f9fc4c14401",
                        "licence_plate": "CjyC6xh2F",
                        "description": "Van 1"
                    },
                    "user": {
                        "uuid": "9f3d0c01-a8b4-46c5-895b-a3be17741615",
                        "name": "Mr. Jett Stamm",
                        "public_name": "Mr. Jett Stamm"
                    },
                    "visits": {
                        "data": [
                            {
                                "uuid": "9f3d0c01-dcb0-4992-b6d0-7c25e4f1bcac",
                                "type": "task",
                                "order_index": 0,
                                "delivery_time": "09:00:00",
                                "eta_start": "08:25",
                                "eta_end": "09:25",
                                "task": {
                                    "uuid": "9f3d0c01-af0c-4eda-b133-c2a4c38a6ac7",
                                    "type": "delivery",
                                    "external_identifier": "RLMpYYCBfKZb",
                                    "external_reference": null,
                                    "note": null,
                                    "pending_payment_amount": 0,
                                    "external_link": null,
                                    "track_and_trace_link": "http:\/\/localhost\/tr\/jmQJQGCr0GvW",
                                    "delivery_from_date": null,
                                    "delivery_date": "2025-06-25",
                                    "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-06-25T09:57:13.000000Z",
                                    "created_at": "2025-06-25T09:57:12.000000Z",
                                    "tags": [],
                                    "notification_template_uuid": null,
                                    "return_task_uuid": null,
                                    "address": {
                                        "street": "7721 Jacobs Rapids",
                                        "house_number": "3608",
                                        "house_number_extension": null,
                                        "postal_code": "17217",
                                        "city": "Lake Linwood",
                                        "latitude": 5.4321,
                                        "longitude": 5.4321,
                                        "address_line": "7721 Jacobs Rapids 3608",
                                        "full_address_line": "7721 Jacobs Rapids 3608, 17217, Lake Linwood",
                                        "country": {
                                            "iso_code": "NL",
                                            "description": "Nederland"
                                        }
                                    },
                                    "customer": {
                                        "name": "Alexander Spencer",
                                        "email": null,
                                        "phone_number": null
                                    }
                                },
                                "schedule_date": "2025-06-24T22:00:00.000000Z",
                                "status": {
                                    "status_identifier": "delivered"
                                },
                                "signature": "OWYzZDBjMDEtZGNiMC00OTkyLWI2ZDAtN2MyNWU0ZjFiY2Fj"
                            }
                        ]
                    }
                }
            ]
        }
    }
}