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

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

filters.types

string[]

Filter on specific task types.

Must be one of:

delivery
pickup
recurring

Example:

["pickup"]

filters.statuses

string[]

Filter on tasks with a specific status.

Must be one of:

planned
not_planned
delivered
delivery_failed

Example:

["delivery_failed"]

filters.deleted

string

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

Must be one of:

include
only

Example:

only

filters.limit

integer

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

Example:

filters.page

integer

Must be at least 1.

Example:

Response Fields

data

object[]

Collection of tasks

object

uuid

string

The uuid of this task

type

string

enum(delivery|pickup) 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

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

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:

pickup

external_identifier

string

required

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

Example:

zefoaxvptfblcxke

external_reference

string

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

Example:

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:

1997-03-12

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:

5ce73ff7-e8a3-382e-8bd8-5e3ff4372b7d

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:

e9871f50-e492-33a7-a0d4-0c62830148ef

recurring

object

Recurring information.

period

string

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

Must be one of:

week
month

Example:

week

interval

integer

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

Example:

settings

string

Settings when to repeat.

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:

2064-01-25

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-04T14:47:21

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

delivery_from_date

string|null

The earliest date the task is allowed to be completed

delivery_date

string

The date the task is supposed to be completed

start_time

string|null

The time window start time. Timezone: Europe/Amsterdam

end_time

string|null

The time window end time. Timezone: Europe/Amsterdam

delivery_duration_minutes

integer

The time needed on location to complete the task

return_required

boolean

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

signature_required

boolean

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

used_capacity_1

integer

The amount of capacity this task takes

used_capacity_2

integer

The amount of capacity this task takes

used_capacity_3

integer

The amount of capacity this task takes

created_at

string

Date and time when this task was created

updated_at

string

Date and time when this task was updated

tags[]

string[]

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

return_task_uuid

string|null

The uuid of a related return task if available

notification_template_uuid

string|null

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

recurring

object|null

Recurring information

address

object

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

customer

object

Customer information

next_visit

object|null

uuid

string

The uuid of this visit

type

string

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

order_index

integer

Index on which order the visits should be visited

delivery_time

string

The time which this visit should be completed

task_uuid

string|null

The related task to this visit

address

object|null

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country[]

object

Country information

country

object

scanned_codes

object[]|null

Collection of ScannedCodes

Auth

Bearer

Headers

Body

{ "type": "pickup", "external_identifier": "zefoaxvptfblcxke", "external_reference": "hx", "note": "Please deliver at the side door.", "pending_payment_amount": 100, "external_link": "https:\/\/example.com\/", "delivery_from_date": "1997-03-12", "start_time": "08:00", "end_time": "17:00", "delivery_duration_minutes": 4, "return_required": false, "return_task_uuid": "5ce73ff7-e8a3-382e-8bd8-5e3ff4372b7d", "signature_required": false, "used_capacity": 16, "used_capacity_2": 22, "used_capacity_3": 23, "notification_template_uuid": "e9871f50-e492-33a7-a0d4-0c62830148ef", "recurring": { "period": "week", "interval": 7, "settings": "[\"string\", \"third\", \"monday\"]", "end_date": "2064-01-25" }, "address": { "house_number": "12", "house_number_extension": "1A", "street": "LongStreet", "postal_code": "1234AB", "city": "Amsterdam", "country": "NL", "latitude": 12, "longitude": 3 }, "customer": { "email": "[email protected]", "phone_number": "+01 234567890", "name": "Andrew" }, "tags": [ "cooled" ], "delivery_date": "2025-06-04T14:47:21" }

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\": \"pickup\",
    \"external_identifier\": \"zefoaxvptfblcxke\",
    \"external_reference\": \"hx\",
    \"note\": \"Please deliver at the side door.\",
    \"pending_payment_amount\": 100,
    \"external_link\": \"https:\\/\\/example.com\\/\",
    \"delivery_from_date\": \"1997-03-12\",
    \"start_time\": \"08:00\",
    \"end_time\": \"17:00\",
    \"delivery_duration_minutes\": 4,
    \"return_required\": false,
    \"return_task_uuid\": \"5ce73ff7-e8a3-382e-8bd8-5e3ff4372b7d\",
    \"signature_required\": false,
    \"used_capacity\": 16,
    \"used_capacity_2\": 22,
    \"used_capacity_3\": 23,
    \"notification_template_uuid\": \"e9871f50-e492-33a7-a0d4-0c62830148ef\",
    \"recurring\": {
        \"period\": \"week\",
        \"interval\": 7,
        \"settings\": \"[\\\"string\\\", \\\"third\\\", \\\"monday\\\"]\",
        \"end_date\": \"2064-01-25\"
    },
    \"address\": {
        \"house_number\": \"12\",
        \"house_number_extension\": \"1A\",
        \"street\": \"LongStreet\",
        \"postal_code\": \"1234AB\",
        \"city\": \"Amsterdam\",
        \"country\": \"NL\",
        \"latitude\": 12,
        \"longitude\": 3
    },
    \"customer\": {
        \"email\": \"[email protected]\",
        \"phone_number\": \"+01 234567890\",
        \"name\": \"Andrew\"
    },
    \"tags\": [
        \"cooled\"
    ],
    \"delivery_date\": \"2025-06-04T14:47:21\"
}"

$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' => 'pickup',
            'external_identifier' => 'zefoaxvptfblcxke',
            'external_reference' => 'hx',
            'note' => 'Please deliver at the side door.',
            'pending_payment_amount' => 100.0,
            'external_link' => 'https://example.com/',
            'delivery_from_date' => '1997-03-12',
            'start_time' => '08:00',
            'end_time' => '17:00',
            'delivery_duration_minutes' => 4,
            'return_required' => false,
            'return_task_uuid' => '5ce73ff7-e8a3-382e-8bd8-5e3ff4372b7d',
            'signature_required' => false,
            'used_capacity' => 16,
            'used_capacity_2' => 22,
            'used_capacity_3' => 23,
            'notification_template_uuid' => 'e9871f50-e492-33a7-a0d4-0c62830148ef',
            'recurring' => [
                'period' => 'week',
                'interval' => 7,
                'settings' => '["string", "third", "monday"]',
                'end_date' => '2064-01-25',
            ],
            'address' => [
                'house_number' => '12',
                'house_number_extension' => '1A',
                'street' => 'LongStreet',
                'postal_code' => '1234AB',
                'city' => 'Amsterdam',
                'country' => 'NL',
                'latitude' => 12,
                'longitude' => 3,
            ],
            'customer' => [
                'email' => '[email protected]',
                'phone_number' => '+01 234567890',
                'name' => 'Andrew',
            ],
            'tags' => [
                'cooled',
            ],
            'delivery_date' => '2025-06-04T14:47:21',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response:

{
    "uuid": "9f130a2e-81eb-4853-8cb0-521bffed4960",
    "type": "delivery",
    "external_identifier": "RLL8mVd9gLBx",
    "external_reference": null,
    "note": null,
    "pending_payment_amount": 0,
    "external_link": null,
    "delivery_from_date": null,
    "delivery_date": "2025-06-04",
    "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-04T12:47:20.000000Z",
    "created_at": "2025-06-04T12:47:20.000000Z",
    "tags": [],
    "notification_template_uuid": null,
    "return_task_uuid": null,
    "address": {
        "street": "",
        "house_number": "",
        "house_number_extension": "",
        "postal_code": "",
        "city": "",
        "latitude": 1,
        "longitude": 1,
        "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:

fb42aff9-bd3c-35bf-89cf-216f3998e43d

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

delivery_from_date

string|null

The earliest date the task is allowed to be completed

delivery_date

string

The date the task is supposed to be completed

start_time

string|null

The time window start time. Timezone: Europe/Amsterdam

end_time

string|null

The time window end time. Timezone: Europe/Amsterdam

delivery_duration_minutes

integer

The time needed on location to complete the task

return_required

boolean

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

signature_required

boolean

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

used_capacity_1

integer

The amount of capacity this task takes

used_capacity_2

integer

The amount of capacity this task takes

used_capacity_3

integer

The amount of capacity this task takes

created_at

string

Date and time when this task was created

updated_at

string

Date and time when this task was updated

tags[]

string[]

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

return_task_uuid

string|null

The uuid of a related return task if available

notification_template_uuid

string|null

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

recurring

object|null

Recurring information

address

object

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

customer

object

Customer information

next_visit

object|null

uuid

string

The uuid of this visit

type

string

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

order_index

integer

Index on which order the visits should be visited

delivery_time

string

The time which this visit should be completed

task_uuid

string|null

The related task to this visit

address

object|null

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country[]

object

Country information

country

object

scanned_codes

object[]|null

Collection of ScannedCodes

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/tasks/fb42aff9-bd3c-35bf-89cf-216f3998e43d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
    "type": "delivery",
    "external_identifier": "s0bwvC",
    "external_reference": null,
    "note": null,
    "pending_payment_amount": 0,
    "external_link": null,
    "delivery_from_date": null,
    "delivery_date": "2025-06-04",
    "start_time": "09: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-04T12:47:19.000000Z",
    "created_at": "2025-06-04T12:47:19.000000Z",
    "tags": [],
    "notification_template_uuid": null,
    "return_task_uuid": null,
    "address": {
        "street": "86229 Raleigh Spur Suite 501",
        "house_number": "145",
        "house_number_extension": null,
        "postal_code": "83115-9582",
        "city": "Louieside",
        "latitude": 11.102357,
        "longitude": 147.014092,
        "address_line": "86229 Raleigh Spur Suite 501 145",
        "full_address_line": "86229 Raleigh Spur Suite 501 145, 83115-9582, Louieside",
        "country": {
            "iso_code": "NL",
            "description": "Nederland"
        }
    },
    "customer": {
        "name": "Okey Leannon",
        "email": null,
        "phone_number": null
    },
    "next_visit": {
        "uuid": "9f130a2d-589d-49ba-b10c-e85cdba980d6",
        "type": "task",
        "order_index": 0,
        "delivery_time": "09:00:00",
        "schedule_date": "2025-06-03T22:00:00.000000Z",
        "address": {
            "street": "86229 Raleigh Spur Suite 501",
            "house_number": "145",
            "house_number_extension": null,
            "postal_code": "83115-9582",
            "city": "Louieside",
            "latitude": 11.102357,
            "longitude": 147.014092,
            "address_line": "86229 Raleigh Spur Suite 501 145",
            "full_address_line": "86229 Raleigh Spur Suite 501 145, 83115-9582, Louieside",
            "country": {
                "iso_code": "NL",
                "description": "Nederland"
            }
        },
        "scanned_codes": {
            "data": [
                {
                    "type": "task_code",
                    "code_uuid": "9f130a2d-5520-4af6-ab96-f47719ceab99",
                    "scanned_count": 1
                },
                {
                    "type": "schedule_visit_code",
                    "code_uuid": "9f130a2d-642b-48d7-a2dd-bfba418e3188",
                    "scanned_count": 1
                }
            ]
        },
        "status": {
            "status_identifier": "delivered"
        }
    }
}

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:

c48e5237-190f-3d4d-aad4-3cca52423ef6

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:

fyhoinku

external_reference

string

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

Example:

hrdpxfy

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:

1998-05-28

start_time

string

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

Example:

08:00

end_time

string

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:

095f9408-d746-3aba-8027-a9401cb726a4

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:

639aab01-ff18-349c-82d3-c55417dd6d83

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:

2097-07-29

address

object

house_number

string

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

Example:

house_number_extension

string

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

Example:

street

string

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

Example:

LongStreet

postal_code

string

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

Example:

1234AB

city

string

The city. Must not be greater than 255 characters.

Example:

Amsterdam

country

string

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

Example:

latitude

number

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

Example:

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-04T14:47:21

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

delivery_from_date

string|null

The earliest date the task is allowed to be completed

delivery_date

string

The date the task is supposed to be completed

start_time

string|null

The time window start time. Timezone: Europe/Amsterdam

end_time

string|null

The time window end time. Timezone: Europe/Amsterdam

delivery_duration_minutes

integer

The time needed on location to complete the task

return_required

boolean

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

signature_required

boolean

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

used_capacity_1

integer

The amount of capacity this task takes

used_capacity_2

integer

The amount of capacity this task takes

used_capacity_3

integer

The amount of capacity this task takes

created_at

string

Date and time when this task was created

updated_at

string

Date and time when this task was updated

tags[]

string[]

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

return_task_uuid

string|null

The uuid of a related return task if available

notification_template_uuid

string|null

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

recurring

object|null

Recurring information

address

object

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country

object

Country information

customer

object

Customer information

next_visit

object|null

uuid

string

The uuid of this visit

type

string

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

order_index

integer

Index on which order the visits should be visited

delivery_time

string

The time which this visit should be completed

task_uuid

string|null

The related task to this visit

address

object|null

Address information

street

string

The street name

house_number

string

The house number

house_number_extension

string|null

Extra information about the house number

postal_code

string

The postal code

city

string

The city

latitude

number

The latitude of the address

longitude

number

The longitude of the address

country[]

object

Country information

country

object

scanned_codes

object[]|null

Collection of ScannedCodes

Auth

Bearer

Headers

URL Parameters

Body

{ "type": "delivery", "external_identifier": "fyhoinku", "external_reference": "hrdpxfy", "note": "Please deliver at the side door.", "pending_payment_amount": 100, "external_link": "https:\/\/example.com\/", "delivery_from_date": "1998-05-28", "start_time": "08:00", "end_time": "17:00", "delivery_duration_minutes": 21, "return_required": false, "return_task_uuid": "095f9408-d746-3aba-8027-a9401cb726a4", "signature_required": false, "used_capacity": 1, "used_capacity_2": 2, "used_capacity_3": 18, "notification_template_uuid": "639aab01-ff18-349c-82d3-c55417dd6d83", "recurring": { "period": "month", "interval": 8, "settings": "[\"string\", \"third\", \"monday\"]", "end_date": "2097-07-29" }, "address": { "house_number": "12", "house_number_extension": "1A", "street": "LongStreet", "postal_code": "1234AB", "city": "Amsterdam", "country": "NL", "latitude": 8, "longitude": 25 }, "customer": { "email": "[email protected]", "phone_number": "+01 234567890", "name": "Andrew" }, "tags": [ "cooled" ], "delivery_date": "2025-06-04T14:47:21" }

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/tasks/c48e5237-190f-3d4d-aad4-3cca52423ef6" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"type\": \"delivery\",
    \"external_identifier\": \"fyhoinku\",
    \"external_reference\": \"hrdpxfy\",
    \"note\": \"Please deliver at the side door.\",
    \"pending_payment_amount\": 100,
    \"external_link\": \"https:\\/\\/example.com\\/\",
    \"delivery_from_date\": \"1998-05-28\",
    \"start_time\": \"08:00\",
    \"end_time\": \"17:00\",
    \"delivery_duration_minutes\": 21,
    \"return_required\": false,
    \"return_task_uuid\": \"095f9408-d746-3aba-8027-a9401cb726a4\",
    \"signature_required\": false,
    \"used_capacity\": 1,
    \"used_capacity_2\": 2,
    \"used_capacity_3\": 18,
    \"notification_template_uuid\": \"639aab01-ff18-349c-82d3-c55417dd6d83\",
    \"recurring\": {
        \"period\": \"month\",
        \"interval\": 8,
        \"settings\": \"[\\\"string\\\", \\\"third\\\", \\\"monday\\\"]\",
        \"end_date\": \"2097-07-29\"
    },
    \"address\": {
        \"house_number\": \"12\",
        \"house_number_extension\": \"1A\",
        \"street\": \"LongStreet\",
        \"postal_code\": \"1234AB\",
        \"city\": \"Amsterdam\",
        \"country\": \"NL\",
        \"latitude\": 8,
        \"longitude\": 25
    },
    \"customer\": {
        \"email\": \"[email protected]\",
        \"phone_number\": \"+01 234567890\",
        \"name\": \"Andrew\"
    },
    \"tags\": [
        \"cooled\"
    ],
    \"delivery_date\": \"2025-06-04T14:47:21\"
}"

$client = new \GuzzleHttp\Client();
$url = 'https://api.routelogic.io/api/v2/tasks/c48e5237-190f-3d4d-aad4-3cca52423ef6';
$response = $client->put(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_API_KEY}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'type' => 'delivery',
            'external_identifier' => 'fyhoinku',
            'external_reference' => 'hrdpxfy',
            'note' => 'Please deliver at the side door.',
            'pending_payment_amount' => 100.0,
            'external_link' => 'https://example.com/',
            'delivery_from_date' => '1998-05-28',
            'start_time' => '08:00',
            'end_time' => '17:00',
            'delivery_duration_minutes' => 21,
            'return_required' => false,
            'return_task_uuid' => '095f9408-d746-3aba-8027-a9401cb726a4',
            'signature_required' => false,
            'used_capacity' => 1,
            'used_capacity_2' => 2,
            'used_capacity_3' => 18,
            'notification_template_uuid' => '639aab01-ff18-349c-82d3-c55417dd6d83',
            'recurring' => [
                'period' => 'month',
                'interval' => 8,
                'settings' => '["string", "third", "monday"]',
                'end_date' => '2097-07-29',
            ],
            'address' => [
                'house_number' => '12',
                'house_number_extension' => '1A',
                'street' => 'LongStreet',
                'postal_code' => '1234AB',
                'city' => 'Amsterdam',
                'country' => 'NL',
                'latitude' => 8,
                'longitude' => 25,
            ],
            'customer' => [
                'email' => '[email protected]',
                'phone_number' => '+01 234567890',
                'name' => 'Andrew',
            ],
            'tags' => [
                'cooled',
            ],
            'delivery_date' => '2025-06-04T14:47:21',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Example response:

{
    "uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
    "type": "delivery",
    "external_identifier": "RLHz9aKnlzBj",
    "external_reference": null,
    "note": null,
    "pending_payment_amount": 0,
    "external_link": null,
    "delivery_from_date": null,
    "delivery_date": "2025-06-04",
    "start_time": "09: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-04T12:47:20.000000Z",
    "created_at": "2025-06-04T12:47:19.000000Z",
    "tags": [],
    "notification_template_uuid": null,
    "return_task_uuid": null,
    "address": {
        "street": "86229 Raleigh Spur Suite 501",
        "house_number": "145",
        "house_number_extension": null,
        "postal_code": "83115-9582",
        "city": "Louieside",
        "latitude": 11.102357,
        "longitude": 147.014092,
        "address_line": "86229 Raleigh Spur Suite 501 145",
        "full_address_line": "86229 Raleigh Spur Suite 501 145, 83115-9582, Louieside",
        "country": {
            "iso_code": "NL",
            "description": "Nederland"
        }
    },
    "customer": {
        "name": "Okey Leannon",
        "email": null,
        "phone_number": null
    },
    "next_visit": {
        "uuid": "9f130a2d-589d-49ba-b10c-e85cdba980d6",
        "type": "task",
        "order_index": 0,
        "delivery_time": "09:00:00",
        "schedule_date": "2025-06-03T22:00:00.000000Z",
        "address": {
            "street": "86229 Raleigh Spur Suite 501",
            "house_number": "145",
            "house_number_extension": null,
            "postal_code": "83115-9582",
            "city": "Louieside",
            "latitude": 11.102357,
            "longitude": 147.014092,
            "address_line": "86229 Raleigh Spur Suite 501 145",
            "full_address_line": "86229 Raleigh Spur Suite 501 145, 83115-9582, Louieside",
            "country": {
                "iso_code": "NL",
                "description": "Nederland"
            }
        },
        "scanned_codes": {
            "data": [
                {
                    "type": "task_code",
                    "code_uuid": "9f130a2d-5520-4af6-ab96-f47719ceab99",
                    "scanned_count": 1
                },
                {
                    "type": "schedule_visit_code",
                    "code_uuid": "9f130a2d-642b-48d7-a2dd-bfba418e3188",
                    "scanned_count": 1
                }
            ]
        },
        "status": {
            "status_identifier": "delivered"
        }
    }
}

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:

cdb88539-2d3f-3f9f-b2a5-d18e65bef15e

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/cdb88539-2d3f-3f9f-b2a5-d18e65bef15e?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:

1f19003c-1554-3a69-aaef-3081f1cb1155

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/1f19003c-1554-3a69-aaef-3081f1cb1155/products" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f130a2d-539f-4eaa-bfc6-8cfff67982b1",
            "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:

276769d9-7203-36b4-b813-4c8a5d5e7cb0

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:

oouslrsehelqzib

quantity

number

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

Example:

unit

string

The unit of this product.

Must be one of:

pieces
weight

Example:

weight

description

string

required

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

Example:

Table

Response Fields

data

object[]

Collection of products

object

Auth

Bearer

Headers

URL Parameters

Body

{ "data": [ { "identifier": "oouslrsehelqzib", "quantity": 7, "unit": "weight", "description": "Table" } ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/tasks/276769d9-7203-36b4-b813-4c8a5d5e7cb0/products" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": [
        {
            \"identifier\": \"oouslrsehelqzib\",
            \"quantity\": 7,
            \"unit\": \"weight\",
            \"description\": \"Table\"
        }
    ]
}"

Example response:

{
    "data": [
        {
            "uuid": "9f130a2f-0787-4f9e-8931-e461d4614e95",
            "quantity": 1,
            "description": "Test line",
            "unit": "pieces",
            "identifier": "2f7e673aae64ffbe3821016e253b45ed"
        },
        {
            "uuid": "9f130a2f-086c-4302-8485-0eed18afe928",
            "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:

186ae97b-38c1-3cde-bc80-a00b96c03476

product_uuid

string

uuid of the corresponding product

Example:

5c37d050-ad71-32a6-97f3-8c5f323f9604

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/186ae97b-38c1-3cde-bc80-a00b96c03476/products/5c37d050-ad71-32a6-97f3-8c5f323f9604" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f130a2d-539f-4eaa-bfc6-8cfff67982b1",
        "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:

e8083c72-fa7e-30d2-9e4f-c12b1fba059b

product_uuid

string

uuid of the corresponding product

Example:

1ee4da7c-63e9-3399-a229-d1eb2faade4d

Body Parameters

identifier

string

Example:

fidnuyvernkagg

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

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/tasks/e8083c72-fa7e-30d2-9e4f-c12b1fba059b/products/1ee4da7c-63e9-3399-a229-d1eb2faade4d" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"identifier\": \"fidnuyvernkagg\",
    \"quantity\": 10,
    \"unit\": \"weight\",
    \"description\": \"Table\"
}"

Example response:

{
    "data": {
        "uuid": "9f130a2d-539f-4eaa-bfc6-8cfff67982b1",
        "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:

e408e497-8401-3afd-b6b4-1935e33f3096

product_uuid

string

uuid of the corresponding product

Example:

d6537a1a-39a3-3c99-85f5-814a89a3baa9

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/tasks/e408e497-8401-3afd-b6b4-1935e33f3096/products/d6537a1a-39a3-3c99-85f5-814a89a3baa9" \
    --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:

d96dab3b-80bc-3b75-b4a6-9af4060906e1

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/tasks/d96dab3b-80bc-3b75-b4a6-9af4060906e1/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:

7e92af9b-c886-32b7-b423-edf4d9f71eda

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/7e92af9b-c886-32b7-b423-edf4d9f71eda/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f130a2d-5520-4af6-ab96-f47719ceab99",
            "amount": 1,
            "code": "LgxVmarJz4bIb0sv",
            "description": "lamp"
        }
    ]
}

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:

f9d3a64a-1c22-3812-b354-ae1a83dba290

Body Parameters

data

object[]

Response Fields

data

object[]

Collection of codes

Auth

Bearer

Headers

URL Parameters

Body

{ "data": [ { "amount": 10, "code": "bhozjjujcemwuohrhufn", "description": "Table" } ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/tasks/f9d3a64a-1c22-3812-b354-ae1a83dba290/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": [
        {
            \"amount\": 10,
            \"code\": \"bhozjjujcemwuohrhufn\",
            \"description\": \"Table\"
        }
    ]
}"

Example response:

{
    "data": [
        {
            "uuid": "9f130a2f-304a-49bd-956a-94ceec021f52",
            "amount": 1,
            "code": "1234567890",
            "description": "Box"
        },
        {
            "uuid": "9f130a2f-3169-45f5-bb6a-fa5d7f023a65",
            "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:

6a06758e-3a67-3277-bf8f-5e6d3c1c0678

taskCode_uuid

string

uuid of the corresponding task code

Example:

08f7fe89-25d9-3b18-a79c-1e67ea0c9eb6

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/6a06758e-3a67-3277-bf8f-5e6d3c1c0678/codes/08f7fe89-25d9-3b18-a79c-1e67ea0c9eb6" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f130a2d-5520-4af6-ab96-f47719ceab99",
        "amount": 1,
        "code": "LgxVmarJz4bIb0sv",
        "description": "lamp"
    }
}

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:

83a36f45-eea9-32a2-b824-7805902eb3ce

taskCode_uuid

string

uuid of the corresponding task code

Example:

3bb34d34-4547-3227-ad33-53f4650d0420

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:

szgsh

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

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/tasks/83a36f45-eea9-32a2-b824-7805902eb3ce/codes/3bb34d34-4547-3227-ad33-53f4650d0420" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"amount\": 7,
    \"code\": \"szgsh\",
    \"description\": \"Table\"
}"

Example response:

{
    "data": {
        "uuid": "9f130a2d-5520-4af6-ab96-f47719ceab99",
        "amount": 1,
        "code": "LgxVmarJz4bIb0sv",
        "description": "lamp"
    }
}

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:

98987958-5778-3bdd-869a-955f5c4768b3

taskCode_uuid

string

uuid of the corresponding task code

Example:

24e1d98d-d260-32ab-898b-ad3936daad93

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/tasks/98987958-5778-3bdd-869a-955f5c4768b3/codes/24e1d98d-d260-32ab-898b-ad3936daad93" \
    --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:

71f0dd71-4052-370b-8749-b379b230c34b

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/71f0dd71-4052-370b-8749-b379b230c34b/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "9f130a2d-642b-48d7-a2dd-bfba418e3188",
            "amount": 1,
            "code": "2O3mVBJstLgbfXcM",
            "description": "table"
        }
    ]
}

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:

44aadaa6-354c-3211-8287-58f3fbc887a9

Body Parameters

data

object[]

Response Fields

data

object[]

Collection of codes

Auth

Bearer

Headers

URL Parameters

Body

{ "data": [ { "amount": 10, "code": "fjypueatpujbnbzcvznw", "description": "Table" } ] }

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/visits/44aadaa6-354c-3211-8287-58f3fbc887a9/codes" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"data\": [
        {
            \"amount\": 10,
            \"code\": \"fjypueatpujbnbzcvznw\",
            \"description\": \"Table\"
        }
    ]
}"

Example response:

{
    "data": [
        {
            "uuid": "9f130a2f-cab1-4d3c-abc2-2104f4713d5c",
            "amount": 1,
            "code": "1234567890",
            "description": "Box"
        },
        {
            "uuid": "9f130a2f-cbac-4e1f-abbe-6ade1e3dfca6",
            "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:

b8b6b03f-e68d-38aa-bc3d-1c03a2c47f4c

scheduleVisitCode_uuid

string

uuid of the corresponding scheduled visit code

Example:

16644cf4-1341-3eea-8ec5-5561662424b3

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/b8b6b03f-e68d-38aa-bc3d-1c03a2c47f4c/codes/16644cf4-1341-3eea-8ec5-5561662424b3" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f130a2d-642b-48d7-a2dd-bfba418e3188",
        "amount": 1,
        "code": "2O3mVBJstLgbfXcM",
        "description": "table"
    }
}

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:

31ccd268-94c7-38c4-bfa9-25a4fa78610f

scheduleVisitCode_uuid

string

uuid of the corresponding scheduled visit code

Example:

b6ff15df-3f69-356c-8574-6998572a597e

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:

uzfulntzgwrwzgfrgilhg

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

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/visits/31ccd268-94c7-38c4-bfa9-25a4fa78610f/codes/b6ff15df-3f69-356c-8574-6998572a597e" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"amount\": 7,
    \"code\": \"uzfulntzgwrwzgfrgilhg\",
    \"description\": \"Table\"
}"

Example response:

{
    "data": {
        "uuid": "9f130a2d-642b-48d7-a2dd-bfba418e3188",
        "amount": 1,
        "code": "2O3mVBJstLgbfXcM",
        "description": "table"
    }
}

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:

a19cdaeb-0abf-3182-9142-9405159083c7

scheduleVisitCode_uuid

string

uuid of the corresponding scheduled visit code

Example:

fae0533e-300c-3fdd-a288-4c18062da45c

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/visits/a19cdaeb-0abf-3182-9142-9405159083c7/codes/fae0533e-300c-3fdd-a288-4c18062da45c" \
    --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

Example:

["task_deleted"]

Response Fields

uuid

string

Webhook ID

name

string

The name of this webhook group

description

string

The description of this webhook group

webhook_url

string

The url where you receive your webhooks

events[]

string[]

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

Auth

Bearer

Headers

Body

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

Received response

Example request:

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

Example response:

{
    "data": {
        "uuid": "9f130a2f-670f-44bc-b726-1361342bdbb8",
        "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:

07f5c8ad-ea4c-3abc-a51e-06d2d00a0662

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/07f5c8ad-ea4c-3abc-a51e-06d2d00a0662" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "9f130a2d-7e73-4cc4-a985-61916f4e0964",
        "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:

4d932304-6d89-39f6-ae2c-13423f4e1be8

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

Example:

["task_deleted"]

Response Fields

uuid

string

Webhook ID

name

string

The name of this webhook group

description

string

The description of this webhook group

webhook_url

string

The url where you receive your webhooks

events[]

string[]

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

Auth

Bearer

Headers

URL Parameters

Body

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

Received response

Example request:

curl --request PUT \
    "https://api.routelogic.io/api/v2/webhookGroups/4d932304-6d89-39f6-ae2c-13423f4e1be8" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"webhook\",
    \"description\": \"Webhook for listening to when a task is created\",
    \"webhook_url\": \"https:\\/\\/example.com\\/webhook\",
    \"webhook_secret\": \"token\",
    \"events\": [
        \"task_deleted\"
    ]
}"

Example response:

{
    "data": {
        "uuid": "9f130a2d-7e73-4cc4-a985-61916f4e0964",
        "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:

cfd9648d-df43-3f3f-811a-8fb77c651709

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request DELETE \
    "https://api.routelogic.io/api/v2/webhookGroups/cfd9648d-df43-3f3f-811a-8fb77c651709" \
    --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]=19&filters[page]=65" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": [
        {
            "uuid": "8656a6fe-7bb7-4f26-8cde-c22177995619",
            "webhook_url": "https://test.com/webhook/",
            "event_data": {
                "data": {
                    "note": null,
                    "tags": [],
                    "type": "delivery",
                    "uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
                    "end_time": "17:00:00",
                    "recurring": null,
                    "created_at": "2025-06-04T12:47:19.000000Z",
                    "start_time": "09:00:00",
                    "updated_at": "2025-06-04T12:47:19.000000Z",
                    "delivery_date": "2025-06-04",
                    "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": "s0bwvC",
                    "pending_payment_amount": 0,
                    "delivery_duration_minutes": 0,
                    "notification_template_uuid": null
                },
                "type": "task_created",
                "timestamp": "2025-06-04T14:47:19+02:00"
            },
            "response_status": 200,
            "created_at": "2025-06-04T12:47:19.000000Z",
            "updated_at": "2025-06-04T12:47:19.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:

ab7ae1b6-7133-374e-91c3-cbe89deaa5f7

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/ab7ae1b6-7133-374e-91c3-cbe89deaa5f7" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "8656a6fe-7bb7-4f26-8cde-c22177995619",
        "webhook_url": "https://test.com/webhook/",
        "event_data": {
            "data": {
                "note": null,
                "tags": [],
                "type": "delivery",
                "uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
                "end_time": "17:00:00",
                "recurring": null,
                "created_at": "2025-06-04T12:47:19.000000Z",
                "start_time": "09:00:00",
                "updated_at": "2025-06-04T12:47:19.000000Z",
                "delivery_date": "2025-06-04",
                "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": "s0bwvC",
                "pending_payment_amount": 0,
                "delivery_duration_minutes": 0,
                "notification_template_uuid": null
            },
            "type": "task_created",
            "timestamp": "2025-06-04T14:47:19+02:00"
        },
        "response_status": 200,
        "created_at": "2025-06-04T12:47:19.000000Z",
        "updated_at": "2025-06-04T12:47:19.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:

c9636f62-4628-3e05-9291-3037c8cfc1b0

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request POST \
    "https://api.routelogic.io/api/v2/webhookEvents/c9636f62-4628-3e05-9291-3037c8cfc1b0/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

URL Parameters

webhookEvent_uuid

string

uuid of the corresponding webhook event

Example:

0bab8bf8-a281-3fcc-a567-6e37b2711c12

Auth

Bearer

Headers

URL Parameters

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": "9f130a2d-1488-4161-8cb5-8d0ea4a0ff4a",
            "identifier": "DxOPnxaMksgJx69D",
            "title": "Standaard e-mail en SMS notificatie voor bezorgen",
            "default": true,
            "default_pickup": false
        },
        {
            "uuid": "9f130a2d-179f-417d-b640-428db9825b33",
            "identifier": "WSZi56xCdFrY9qeD",
            "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-04

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

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

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

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

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:

f80b9a22-b1ff-3c5f-9c49-caca10ef6f11

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

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

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

Auth

Bearer

Headers

URL Parameters

Received response

Example request:

curl --request GET \
    --get "https://api.routelogic.io/api/v2/schedules/f80b9a22-b1ff-3c5f-9c49-caca10ef6f11" \
    --header "Authorization: Bearer {YOUR_API_KEY}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json"

Example response:

{
    "data": {
        "uuid": "a4388124-d4e8-4136-84f3-727568609907",
        "date": "2025-06-04",
        "description": "Example Schedule 1",
        "total_travel_time": 0,
        "total_distance": 0,
        "notifications_send": false,
        "schedule_vehicles": {
            "data": [
                {
                    "uuid": "9f130a2d-5761-4cc0-a348-649d0a740c5b",
                    "start_time": "08:00:00",
                    "end_time": "10:00:00",
                    "started_at": "2025-06-04 08:03:00",
                    "finished_at": "2025-06-04 10:02:00",
                    "total_travel_time": 0,
                    "total_distance": 1850,
                    "vehicle": {
                        "uuid": "9f130a2d-24ee-4438-b3e4-29d9a48b3fa0",
                        "licence_plate": "zOFMVUU4O",
                        "description": "Van 1"
                    },
                    "user": {
                        "uuid": "9f130a2d-2e2a-4401-bcce-d55e6be0c42a",
                        "name": "Mohammed Hahn",
                        "public_name": "Mohammed Hahn"
                    },
                    "visits": {
                        "data": [
                            {
                                "uuid": "9f130a2d-589d-49ba-b10c-e85cdba980d6",
                                "type": "task",
                                "order_index": 0,
                                "delivery_time": "09:00:00",
                                "task": {
                                    "uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
                                    "type": "delivery",
                                    "external_identifier": "RLHz9aKnlzBj",
                                    "external_reference": null,
                                    "note": null,
                                    "pending_payment_amount": 0,
                                    "external_link": null,
                                    "delivery_from_date": null,
                                    "delivery_date": "2025-06-04",
                                    "start_time": "09: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-04T12:47:20.000000Z",
                                    "created_at": "2025-06-04T12:47:19.000000Z",
                                    "tags": [],
                                    "notification_template_uuid": null,
                                    "return_task_uuid": null,
                                    "address": {
                                        "street": "86229 Raleigh Spur Suite 501",
                                        "house_number": "145",
                                        "house_number_extension": null,
                                        "postal_code": "83115-9582",
                                        "city": "Louieside",
                                        "latitude": 11.102357,
                                        "longitude": 147.014092,
                                        "address_line": "86229 Raleigh Spur Suite 501 145",
                                        "full_address_line": "86229 Raleigh Spur Suite 501 145, 83115-9582, Louieside",
                                        "country": {
                                            "iso_code": "NL",
                                            "description": "Nederland"
                                        }
                                    },
                                    "customer": {
                                        "name": "Okey Leannon",
                                        "email": null,
                                        "phone_number": null
                                    }
                                },
                                "schedule_date": "2025-06-03T22:00:00.000000Z",
                                "address": {
                                    "street": "86229 Raleigh Spur Suite 501",
                                    "house_number": "145",
                                    "house_number_extension": null,
                                    "postal_code": "83115-9582",
                                    "city": "Louieside",
                                    "latitude": 11.102357,
                                    "longitude": 147.014092,
                                    "address_line": "86229 Raleigh Spur Suite 501 145",
                                    "full_address_line": "86229 Raleigh Spur Suite 501 145, 83115-9582, Louieside",
                                    "country": {
                                        "iso_code": "NL",
                                        "description": "Nederland"
                                    }
                                },
                                "scanned_codes": {
                                    "data": [
                                        {
                                            "type": "task_code",
                                            "code_uuid": "9f130a2d-5520-4af6-ab96-f47719ceab99",
                                            "scanned_count": 1
                                        },
                                        {
                                            "type": "schedule_visit_code",
                                            "code_uuid": "9f130a2d-642b-48d7-a2dd-bfba418e3188",
                                            "scanned_count": 1
                                        }
                                    ]
                                },
                                "status": {
                                    "status_identifier": "delivered"
                                }
                            }
                        ]
                    }
                }
            ]
        }
    }
}

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:

50651.07778

longitude

number

required

The longitude of the task.

Example:

81.643

tags

string[]

Must not be greater than 255 characters.

Example:

["fqnqpswjqoyyohvwkz"]

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:

2050-11-20

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:

2122-10-07

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": 50651.07778, "longitude": 81.643, "tags": [ "fqnqpswjqoyyohvwkz" ], "delivery_duration_minutes": 5, "start_date": "2050-11-20", "end_date": "2122-10-07", "used_capacity": 11, "used_capacity_2": 22, "used_capacity_3": 3, "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\": 50651.07778,
        \"longitude\": 81.643,
        \"tags\": [
            \"fqnqpswjqoyyohvwkz\"
        ],
        \"delivery_duration_minutes\": 5,
        \"start_date\": \"2050-11-20\",
        \"end_date\": \"2122-10-07\",
        \"used_capacity\": 11,
        \"used_capacity_2\": 22,
        \"used_capacity_3\": 3,
        \"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\": \"enim\",
    \"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
    }
}"

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.

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-04T14:47:21+02:00",
    "data": {
        "uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
        "type": "delivery",
        "external_identifier": "s0bwvC",
        "external_reference": null,
        "note": null,
        "pending_payment_amount": 0,
        "external_link": null,
        "delivery_from_date": null,
        "delivery_date": "2025-06-04",
        "start_time": "09: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-04T12:47:19.000000Z",
        "created_at": "2025-06-04T12:47:19.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-04T14:47:21+02:00",
    "data": {
        "uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
        "type": "delivery",
        "external_identifier": "s0bwvC",
        "external_reference": null,
        "note": null,
        "pending_payment_amount": 0,
        "external_link": null,
        "delivery_from_date": null,
        "delivery_date": "2025-06-04",
        "start_time": "09: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-04T12:47:19.000000Z",
        "created_at": "2025-06-04T12:47:19.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-04T14:47:21+02:00",
    "data": {
        "uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
        "type": "delivery",
        "external_identifier": "s0bwvC",
        "external_reference": null,
        "note": null,
        "pending_payment_amount": 0,
        "external_link": null,
        "delivery_from_date": null,
        "delivery_date": "2025-06-04",
        "start_time": "09: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-04T12:47:19.000000Z",
        "created_at": "2025-06-04T12:47:19.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-04T14:47:21+02:00",
    "data": {
        "uuid": "9f130a2d-589d-49ba-b10c-e85cdba980d6",
        "type": "task",
        "order_index": 0,
        "delivery_time": "09:00:00",
        "task": {
            "uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
            "type": "delivery",
            "external_identifier": "s0bwvC",
            "external_reference": null,
            "note": null,
            "pending_payment_amount": 0,
            "external_link": null,
            "delivery_from_date": null,
            "delivery_date": "2025-06-04",
            "start_time": "09: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-04T12:47:19.000000Z",
            "created_at": "2025-06-04T12:47:19.000000Z",
            "tags": [],
            "notification_template_uuid": null,
            "return_task_uuid": null,
            "address": {
                "street": "86229 Raleigh Spur Suite 501",
                "house_number": "145",
                "house_number_extension": null,
                "postal_code": "83115-9582",
                "city": "Louieside",
                "latitude": 11.102357,
                "longitude": 147.014092,
                "address_line": "86229 Raleigh Spur Suite 501 145",
                "full_address_line": "86229 Raleigh Spur Suite 501 145, 83115-9582, Louieside",
                "country": {
                    "iso_code": "NL",
                    "description": "Nederland"
                }
            },
            "customer": {
                "name": "Okey Leannon",
                "email": null,
                "phone_number": null
            }
        },
        "schedule_date": null,
        "status": {
            "status_identifier": "delivered"
        },
        "schedule_uuid": "a4388124-d4e8-4136-84f3-727568609907"
    }
}

internal_note_created

This event is send when an internal note has been created

{
    "type": "internal_note_created",
    "timestamp": "2025-06-04T14:47:21+02:00",
    "data": {
        "message": "This is an example message. Drivers use this to communicate with their managers",
        "visit": {
            "uuid": "9f130a2d-589d-49ba-b10c-e85cdba980d6",
            "type": "task",
            "order_index": 0,
            "delivery_time": "09:00:00",
            "task": {
                "uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
                "type": "delivery",
                "external_identifier": "RLHz9aKnlzBj",
                "external_reference": null,
                "note": null,
                "pending_payment_amount": 0,
                "external_link": null,
                "delivery_from_date": null,
                "delivery_date": "2025-06-04",
                "start_time": "09: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-04T12:47:20.000000Z",
                "created_at": "2025-06-04T12:47:19.000000Z",
                "tags": [],
                "notification_template_uuid": null,
                "return_task_uuid": null,
                "address": {
                    "street": "86229 Raleigh Spur Suite 501",
                    "house_number": "145",
                    "house_number_extension": null,
                    "postal_code": "83115-9582",
                    "city": "Louieside",
                    "latitude": 11.102357,
                    "longitude": 147.014092,
                    "address_line": "86229 Raleigh Spur Suite 501 145",
                    "full_address_line": "86229 Raleigh Spur Suite 501 145, 83115-9582, Louieside",
                    "country": {
                        "iso_code": "NL",
                        "description": "Nederland"
                    }
                },
                "customer": {
                    "name": "Okey Leannon",
                    "email": null,
                    "phone_number": null
                }
            },
            "schedule_date": "2025-06-03T22:00:00.000000Z",
            "status": {
                "status_identifier": "delivered"
            }
        }
    }
}

schedule_calculated

This event is sent everytime a schedule has been calculated

{
    "type": "schedule_calculated",
    "timestamp": "2025-06-04T14:47:21+02:00",
    "data": {
        "uuid": "a4388124-d4e8-4136-84f3-727568609907",
        "date": "2025-06-04",
        "description": "Example Schedule 1",
        "total_travel_time": 0,
        "total_distance": 0,
        "notifications_send": false,
        "schedule_vehicles": {
            "data": [
                {
                    "uuid": "9f130a2d-5761-4cc0-a348-649d0a740c5b",
                    "start_time": "08:00:00",
                    "end_time": "10:00:00",
                    "started_at": "2025-06-04 08:03:00",
                    "finished_at": "2025-06-04 10:02:00",
                    "total_travel_time": 0,
                    "total_distance": 1850,
                    "vehicle": {
                        "uuid": "9f130a2d-24ee-4438-b3e4-29d9a48b3fa0",
                        "licence_plate": "zOFMVUU4O",
                        "description": "Van 1"
                    },
                    "visits": {
                        "data": [
                            {
                                "uuid": "9f130a2d-589d-49ba-b10c-e85cdba980d6",
                                "type": "task",
                                "order_index": 0,
                                "delivery_time": "09:00:00",
                                "task": {
                                    "uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
                                    "external_identifier": "RLHz9aKnlzBj"
                                },
                                "task_uuid": "9f130a2d-338a-4cd2-9cb0-270e3092e351",
                                "schedule_date": "2025-06-03T22:00:00.000000Z",
                                "status": {
                                    "status_identifier": "delivered"
                                }
                            }
                        ]
                    }
                }
            ]
        }
    }
}