# Customer

Last updated:

<!-- -->

October 18, 2026

<!-- -->

\| 12 minutes read

<br />

<br />

The **Customer Rest API** allows you to manage customer records within the Fleet Management system. You can create, retrieve, update, and delete customer data. This Rest API supports filtering, sorting, and pagination to help manage large datasets efficiently.

### Customer Object Fields[​](#customer-object-fields "Direct link to Customer Object Fields")

| Field         | Type    | Description                                   |
| ------------- | ------- | --------------------------------------------- |
| `id`          | Integer | Unique identifier for the customer.           |
| `location`    | Object  | Coordinates of the customer’s location.       |
| `alias`       | String  | Short name or identifier for the customer.    |
| `firstName`   | String  | Customer's first name.                        |
| `lastName`    | String  | Customer's last name.                         |
| `address`     | Object  | Detailed address information of the customer. |
| `email`       | String  | Email address of the customer.                |
| `phoneNumber` | String  | Customer's contact phone number.              |
| `customData`  | String  | Additional customer-specific data.            |

***

## Endpoints[​](#endpoints "Direct link to Endpoints")

### 1. Create Customer[​](#1-create-customer "Direct link to 1. Create Customer")

**Description:** Adds a new customer to the database. The `id` field will be populated, it will return a list of customers with the id field populated

* **Base URL:** `https://api.magiclane.net/api/v1`

* **Endpoint:** `POST /fleetmanagement/customers`

* **Headers:**

  * `Authorization: YOUR_API_KEY`
  * `Content-Type: application/json`

* **Returned error codes:**

| Error Code                  | Description                                                                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `200 Successful`            | Successful operation.                                                                                                                                                    |
| `400 Bad Request`           | - The customer does not have the coordinates set.<br />- The email set for the customer has wrong format.<br />- The phone number set for the customer has wrong format. |
| `401 Unauthorized`          | API key is missing or invalid.                                                                                                                                           |
| `405 Method Not Allowed`    | Incorrect method type.                                                                                                                                                   |
| `500 Internal Server Error` | Database error occurred.                                                                                                                                                 |

Note

If the operation is successful, the `Customer` object will have its `id` field populated. If the operation fails, an error code is returned, which can be interpreted as described in the **Returned error codes** section.

#### Example:[​](#example "Direct link to Example:")

* **Request Body:**

- Schema View
- JSON Example
- JSON View

* `alias`(

  <!-- -->

  string

  <!-- -->

  )

  Short name or identifier for the customer.

* `firstName`(

  <!-- -->

  string

  <!-- -->

  )

  Customer's first name.

* `lastName`(

  <!-- -->

  string

  <!-- -->

  )

  Customer's last name.

* ▶`address`(

  <!-- -->

  object

  <!-- -->

  )

  Detailed address information of the customer.

* `email`(

  <!-- -->

  string

  <!-- -->

  )

  Email address of the customer.

* `phoneNumber`(

  <!-- -->

  string

  <!-- -->

  )

  Customer's contact phone number.

* `location`(

  <!-- -->

  array\[double]

  <!-- -->

  )

  Coordinates of the customer’s location as \[latitude, longitude].

* `customData`(

  <!-- -->

  string

  <!-- -->

  )

  Additional customer-specific data.

```json
[
  {
    "alias": "Magic Customer",
    "firstName": "Magic",
    "lastName": "Customer",
    "address": {
      "country": "France",
      "state": "Île-de-France",
      "county": "Paris",
      "city": "Paris",
      "postalCode": "75010",
      "streetName": "Rue Gustave Goublier",
      "streetNumber": "2",
      "extra": ""
    },
    "email": "magiccustomer@example.com",
    "phoneNumber": "+1202555018",
    "location": [
      48.870852,
      2.356148
    ],
    "customData": ""
  },
  {
    "alias": "Magic Customer 2",
    "firstName": "Magic",
    "lastName": "Customer 2",
    "address": {
      "country": "",
      "state": "",
      "county": "",
      "city": "",
      "postalCode": "",
      "streetName": "",
      "streetNumber": ""
    },
    "email": "magiccustomer2@example.com",
    "phoneNumber": "+1202555018",
    "location": [
      48.870852,
      2.356148
    ],
    "customData": "communicationPreference: email"
  }
]

```

```json
[
  {
    "alias": "string",
    "firstName": "string",
    "lastName": "string",
    "address": {
      "country": "string",
      "state": "string",
      "county": "string",
      "city": "string",
      "postalCode": "string",
      "streetName": "string",
      "streetNumber": "string",
      "extra": "string"
    },
    "email": "string",
    "phoneNumber": "string",
    "location": [
      0,
      0
    ],
    "customData": "string"
  }
]

```

* **Response Body:** (error code `200`)

- Schema View
- JSON Example
- JSON View

* ▶`customers`(

  <!-- -->

  array

  <!-- -->

  )

  List of customer objects.

```json
{
  "customers": [
    {
      "id": 1838721,
      "alias": "Magic Customer",
      "firstName": "Magic",
      "lastName": "Customer",
      "address": {
        "country": "France",
        "state": "Île-de-France",
        "county": "Paris",
        "city": "Paris",
        "postalCode": "75010",
        "streetName": "Rue Gustave Goublier",
        "streetNumber": "2",
        "extra": ""
      },
      "email": "magiccustomer@example.com",
      "phoneNumber": "+1202555018",
      "location": [
        48.870852,
        2.356148
      ],
      "customData": ""
    },
    {
      "id": 1838722,
      "alias": "Magic Customer2",
      "firstName": "Magic",
      "lastName": "Customer2",
      "address": {
        "country": "",
        "state": "",
        "county": "",
        "city": "",
        "postalCode": "",
        "streetName": "",
        "streetNumber": ""
      },
      "email": "magiccustomer2@example.com",
      "phoneNumber": "+1202555018",
      "location": [
        48.870852,
        2.356148
      ],
      "customData": "communicationPreference: email"
    }
  ]
}

```

```json
{
  "customers": [
    {
      "id": 0,
      "alias": "string",
      "firstName": "string",
      "lastName": "string",
      "address": {
        "country": "string",
        "state": "string",
        "county": "string",
        "city": "string",
        "postalCode": "string",
        "streetName": "string",
        "streetNumber": "string",
        "extra": "string"
      },
      "email": "string",
      "phoneNumber": "string",
      "location": [
        0,
        0
      ],
      "customData": "string"
    }
  ]
}

```

***

### 2. Get All Customers[​](#2-get-all-customers "Direct link to 2. Get All Customers")

**Description:** Fetches a list of all customers with optional filtering.

* **Base URL:** `https://api.magiclane.net/api/v1`

* **Endpoint:** `GET /fleetmanagement/customers`

* **Headers:**
  * `Authorization: YOUR_API_KEY`

* **Query Parameters:**

  * `search` (string, *optional*) – General search term across customers.
  * `id` (string, *optional*) – Filter by customer ID (`id=value:exact` for exact match).
  * `alias` (string, *optional*) – Filter by customer alias (`alias=value:exact` for exact match).
  * `firstName` (string, *optional*) – Filter by first name (`firstName=value:exact` for exact match).
  * `lastName` (string, *optional*) – Filter by last name (`lastName=value:exact` for exact match).
  * `location` (string, *optional*) – Filter by location (`location=value:exact` for exact match).
  * `country` (string, *optional*) – Filter by country (`country=value:exact` for exact match).
  * `state` (string, *optional*) – Filter by state (`state=value:exact` for exact match).
  * `county` (string, *optional*) – Filter by county (`county=value:exact` for exact match).
  * `city` (string, *optional*) – Filter by city (`city=value:exact` for exact match).
  * `postalCode` (string, *optional*) – Filter by postal code (`postalCode=value:exact` for exact match).
  * `streetName` (string, *optional*) – Filter by street name (`streetNSame=value:exact` for exact match).
  * `streetNumber` (string, *optional*) – Filter by street number (`streetNumber=value:exact` for exact match).
  * `extra` (string, *optional*) – Filter by extra address value (`extra=value:exact` for exact match).
  * `email` (string, *optional*) – Filter by email (`email=value:exact` for exact match).
  * `phoneNumber` (string, *optional*) – Filter by phone number (`phoneNumber=value:exact` for exact match).
  * `customData` (string, *optional*) – Filter by custom data (`customData=value:exact` for exact match).
  * `sort` (string, *optional*) – Sorting format: `column1:asc/desc,column2:asc/desc`
    * Available columns: `id, alias, firstName, lastName, latitude, longitude, country, state, county, city, postalCode, streetName, streetNumber, extra, email, phoneNumber, customData`.
  * `includeColumns` (string, *optional*) – Specify which columns to include.
    <!-- -->
    * Available columns: `id, alias, idAddress, firstName, lastName, latitude, longitude, country, state, county, city, postalCode, streetName, streetNumber, extra, email, phoneNumber, customData`
  * `page` (integer, *optional*) – Page number for pagination.
  * `per_page` (integer, *optional*) – Number of items per page.

* **Returned error codes:**

| Error Code                  | Description                                                                                |
| --------------------------- | ------------------------------------------------------------------------------------------ |
| `200 Successful`            | Successful operation.                                                                      |
| `400 Bad Request`           | The values sent for page and per\_page parameters are incorrect; should be greater than 0. |
| `401 Unauthorized`          | API key is missing or invalid.                                                             |
| `405 Method Not Allowed`    | Incorrect method type.                                                                     |
| `500 Internal Server Error` | Database error occurred.                                                                   |

#### Example:[​](#example-1 "Direct link to Example:")

* **Response Body:** (error code `200`)

- Schema View
- JSON Example
- JSON View

* ▶`customers`(

  <!-- -->

  array

  <!-- -->

  )

  List of customer objects.

```json
{
  "customers": [
    {
      "id": 1838721,
      "alias": "Magic Customer",
      "firstName": "Magic",
      "lastName": "Customer",
      "address": {
        "country": "France",
        "state": "Île-de-France",
        "county": "Paris",
        "city": "Paris",
        "postalCode": "75010",
        "streetName": "Rue Gustave Goublier",
        "streetNumber": "2",
        "extra": ""
      },
      "email": "magiccustomer@example.com",
      "phoneNumber": "+1202555018",
      "location": [
        48.870852,
        2.356148
      ],
      "customData": ""
    },
    {
      "id": 1838722,
      "alias": "Magic Customer2",
      "firstName": "Magic",
      "lastName": "Customer2",
      "address": {
        "country": "",
        "state": "",
        "county": "",
        "city": "",
        "postalCode": "",
        "streetName": "",
        "streetNumber": ""
      },
      "email": "magiccustomer2@example.com",
      "phoneNumber": "+1202555018",
      "location": [
        48.870852,
        2.356148
      ],
      "customData": "communicationPreference: email"
    }
  ]
}

```

```json
{
  "customers": [
    {
      "id": 0,
      "alias": "string",
      "firstName": "string",
      "lastName": "string",
      "address": {
        "country": "string",
        "state": "string",
        "county": "string",
        "city": "string",
        "postalCode": "string",
        "streetName": "string",
        "streetNumber": "string",
        "extra": "string"
      },
      "email": "string",
      "phoneNumber": "string",
      "location": [
        0,
        0
      ],
      "customData": "string"
    }
  ]
}

```

***

### 3. Get a Customer by ID[​](#3-get-a-customer-by-id "Direct link to 3. Get a Customer by ID")

**Description:** Retrieves a specific customer by ID.

* **Base URL:** `https://api.magiclane.net/api/v1`
* **Endpoint:** `GET /fleetmanagement/customers/{id}`
* **Headers:**
  * `Authorization: YOUR_API_KEY`
* **Path Parameter:**
  * `id` (integer, \**required*) - The unique customer ID.
* **Returned error codes:**

| Error Code                  | Description                               |
| --------------------------- | ----------------------------------------- |
| `200 Successful`            | Successful operation.                     |
| `400 Bad Request`           | Invalid input or missing required fields. |
| `401 Unauthorized`          | API key is missing or invalid.            |
| `404 Not Found`             | Customer not found in database.           |
| `405 Method Not Allowed`    | Incorrect method type.                    |
| `500 Internal Server Error` | Database error occurred.                  |

#### Example:[​](#example-2 "Direct link to Example:")

* **Response Body:** (error code `200`)

- Schema View
- JSON Example
- JSON View

* `id`(

  <!-- -->

  integer

  <!-- -->

  )

  Unique identifier for the customer.

* `alias`(

  <!-- -->

  string

  <!-- -->

  )

  Short name or identifier for the customer.

* `firstName`(

  <!-- -->

  string

  <!-- -->

  )

  Customer's first name.

* `lastName`(

  <!-- -->

  string

  <!-- -->

  )

  Customer's last name.

* ▶`address`(

  <!-- -->

  object

  <!-- -->

  )

  Detailed address information of the customer.

* `email`(

  <!-- -->

  string

  <!-- -->

  )

  Email address of the customer.

* `phoneNumber`(

  <!-- -->

  string

  <!-- -->

  )

  Customer's contact phone number.

* `location`(

  <!-- -->

  array\[double]

  <!-- -->

  )

  Coordinates of the customer’s location as \[latitude, longitude].

* `customData`(

  <!-- -->

  string

  <!-- -->

  )

  Additional customer-specific data.

```json
{
  "id": 1838721,
  "alias": "Magic Customer",
  "firstName": "Magic",
  "lastName": "Customer",
  "address": {
    "country": "France",
    "state": "Île-de-France",
    "county": "Paris",
    "city": "Paris",
    "postalCode": "75010",
    "streetName": "Rue Gustave Goublier",
    "streetNumber": "2",
    "extra": ""
  },
  "email": "magiccustomer@example.com",
  "phoneNumber": "+1202555018",
  "location": [
    48.870852,
    2.356148
  ],
  "customData": ""
}

```

```json
{
  "id": 0,
  "alias": "string",
  "firstName": "string",
  "lastName": "string",
  "address": {
    "country": "string",
    "state": "string",
    "county": "string",
    "city": "string",
    "postalCode": "string",
    "streetName": "string",
    "streetNumber": "string",
    "extra": "string"
  },
  "email": "string",
  "phoneNumber": "string",
  "location": [
    0,
    0
  ],
  "customData": "string"
}

```

***

### 4. Update a Customer[​](#4-update-a-customer "Direct link to 4. Update a Customer")

**Description:** Updates an existing customer record.

* **Base URL:** `https://api.magiclane.net/api/v1`

* **Endpoint:** `PUT /fleetmanagement/customers/{id}`

* **Headers:**

  * `Authorization: YOUR_API_KEY`
  * `Content-Type: application/json`

* **Path Parameter:**
  * id (integer, \**required*) - Customer ID.

* **Returned error codes:**

| Error Code                  | Description                                                                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `200 Successful`            | Successful operation.                                                                                                                                                    |
| `400 Bad Request`           | - The customer does not have the coordinates set.<br />- The email set for the customer has wrong format.<br />- The phone number set for the customer has wrong format. |
| `401 Unauthorized`          | API key is missing or invalid.                                                                                                                                           |
| `404 Not Found`             | Customer not found in database.                                                                                                                                          |
| `405 Method Not Allowed`    | Incorrect method type.                                                                                                                                                   |
| `500 Internal Server Error` | Database error occurred.                                                                                                                                                 |

#### Example:[​](#example-3 "Direct link to Example:")

* **Request Body:**

- Schema View
- JSON Example
- JSON View

* `id`(

  <!-- -->

  integer

  <!-- -->

  )

  Unique identifier for the customer.

* `alias`(

  <!-- -->

  string

  <!-- -->

  )

  Short name or identifier for the customer.

* `firstName`(

  <!-- -->

  string

  <!-- -->

  )

  Customer's first name.

* `lastName`(

  <!-- -->

  string

  <!-- -->

  )

  Customer's last name.

* ▶`address`(

  <!-- -->

  object

  <!-- -->

  )

  Detailed address information of the customer.

* `email`(

  <!-- -->

  string

  <!-- -->

  )

  Email address of the customer.

* `phoneNumber`(

  <!-- -->

  string

  <!-- -->

  )

  Customer's contact phone number.

* `location`(

  <!-- -->

  array\[double]

  <!-- -->

  )

  Coordinates of the customer’s location as \[latitude, longitude].

* `customData`(

  <!-- -->

  string

  <!-- -->

  )

  Additional customer-specific data.

```json
{
  "id": 1838721,
  "alias": "Magic Customer",
  "firstName": "Magic",
  "lastName": "Customer",
  "address": {
    "country": "France",
    "state": "Île-de-France",
    "county": "Paris",
    "city": "Paris",
    "postalCode": "75010",
    "streetName": "Rue Gustave Goublier",
    "streetNumber": "2",
    "extra": ""
  },
  "email": "magiccustomer@example.com",
  "phoneNumber": "+1202555018",
  "location": [
    48.870852,
    2.356148
  ],
  "customData": ""
}

```

```json
{
  "id": 0,
  "alias": "string",
  "firstName": "string",
  "lastName": "string",
  "address": {
    "country": "string",
    "state": "string",
    "county": "string",
    "city": "string",
    "postalCode": "string",
    "streetName": "string",
    "streetNumber": "string",
    "extra": "string"
  },
  "email": "string",
  "phoneNumber": "string",
  "location": [
    0,
    0
  ],
  "customData": "string"
}

```

* **Response Body:** (error code `200`)

```json
{
  "message": "Operation done successfully",
}

```

***

### 5. Delete Customers[​](#5-delete-customers "Direct link to 5. Delete Customers")

**Description:** Deletes customers from the system.

* **Base URL:** `https://api.magiclane.net/api/v1`

* **Endpoint:** `DELETE /fleetmanagement/customers`

* **Headers:**

  * `Authorization: YOUR_API_KEY`
  * `Content-Type: application/json`

* **Returned error codes:**

| Error Code                  | Description                                                         |
| --------------------------- | ------------------------------------------------------------------- |
| `200 Successful`            | Successful operation.                                               |
| `400 Bad Request`           | Invalid input or missing required fields.                           |
| `401 Unauthorized`          | API key is missing or invalid.                                      |
| `404 Not Found`             | Can't delete customers because at least one of them does not exist. |
| `405 Method Not Allowed`    | Incorrect method type.                                              |
| `500 Internal Server Error` | Database error occurred.                                            |

#### Example:[​](#example-4 "Direct link to Example:")

* **Request Body:** -List of customer IDs to delete.

```json
  [12345, 23456, 34567]

```

* **Response Body:** (error code `200`)

```json
{
  "message": "Operation done successfully",
}

```

***

### 6. Get Customer History[​](#6-get-customer-history "Direct link to 6. Get Customer History")

**Description:** Retrieves the order history and associated optimizations for a specific customer.

* **Base URL:** `https://api.magiclane.net/api/v1`

* **Endpoint:** `GET /fleetmanagement/customers/{id}/history`

* **Headers:**

  * `Authorization: YOUR_API_KEY`
  * `Content-Type: application/json`

* **Path Parameter:**
  * `id` (integer, \**required*) - The unique customer ID.

* **Returned error codes:**

| Error Code                  | Description                                                      |
| --------------------------- | ---------------------------------------------------------------- |
| `200 Successful`            | Successful operation.                                            |
| `400 Bad Request`           | The customer was not found or its history couldn’t be retrieved. |
| `401 Unauthorized`          | API key is missing or invalid.                                   |
| `404 Not Found`             | Customer not found in database.                                  |
| `405 Method Not Allowed`    | Incorrect method type.                                           |
| `500 Internal Server Error` | Database error occurred.                                         |

#### Example:[​](#example-5 "Direct link to Example:")

* **Response Body:** (error code `200`)

- Schema View
- JSON Example
- JSON View

* ▶`history`(

  <!-- -->

  array

  <!-- -->

  )

  List of order history entries for the customer.

```json
{
  "history": [
    {
      "order": {
        "id": 933799,
        "creationTimestamp": 1744096603223,
        "customerInfo": {
          "id": 1839506,
          "alias": "",
          "firstName": "",
          "lastName": "",
          "address": {
            "country": "",
            "state": "",
            "county": "",
            "city": "",
            "postalCode": "",
            "streetName": "",
            "streetNumber": ""
          },
          "email": "c1@yahoo.com",
          "phoneNumber": "+12025550181",
          "location": [
            48.827327,
            2.342267
          ],
          "customData": ""
        },
        "location": [
          48.827327,
          2.342267
        ],
        "alias": "",
        "firstName": "",
        "lastName": "",
        "address": {
          "country": "",
          "state": "",
          "county": "",
          "city": "",
          "postalCode": "",
          "streetName": "",
          "streetNumber": ""
        },
        "phoneNumber": "+12025550181",
        "customData": "",
        "type": 0,
        "status": 0,
        "state": 1,
        "priority": 0,
        "numberOfPackages": 0,
        "weight": 0,
        "cube": 0,
        "revenue": 0,
        "timeWindow": [
          420,
          1086
        ],
        "serviceTime": 0,
        "depotId": 0
      },
      "optimizationAndRoute": [
        {
          "optimization": {
            "id": 139950,
            "orders": [
              {
                "id": 933799,
                "creationTimestamp": 1744096603223,
                "customerInfo": {
                  "id": 1839506,
                  "alias": "",
                  "firstName": "",
                  "lastName": "",
                  "address": {
                    "country": "",
                    "state": "",
                    "county": "",
                    "city": "",
                    "postalCode": "",
                    "streetName": "",
                    "streetNumber": ""
                  },
                  "email": "c1@yahoo.com",
                  "phoneNumber": "+12025550181",
                  "location": [
                    48.827327,
                    2.342267
                  ],
                  "customData": ""
                },
                "location": [
                  48.827327,
                  2.342267
                ],
                "alias": "",
                "firstName": "",
                "lastName": "",
                "address": {
                  "country": "",
                  "state": "",
                  "county": "",
                  "city": "",
                  "postalCode": "",
                  "streetName": "",
                  "streetNumber": ""
                },
                "phoneNumber": "+12025550181",
                "customData": "",
                "type": 0,
                "status": 0,
                "state": 1,
                "priority": 0,
                "numberOfPackages": 0,
                "weight": 0,
                "cube": 0,
                "revenue": 0,
                "timeWindow": [
                  420,
                  1086
                ],
                "serviceTime": 0,
                "depotId": 0
              }
            ],
            "departures": [
              {
                "depotId": 0,
                "alias": "Departure1",
                "location": [
                  48.870569,
                  2.356448
                ],
                "address": {
                  "country": "France",
                  "state": "",
                  "county": "Nouvelle-Aquitaine",
                  "city": "Poitiers",
                  "postalCode": "86000",
                  "streetName": "Boulevard Chasseigne",
                  "streetNumber": "34"
                },
                "matchedLocation": [
                  2147483647,
                  2147483647
                ],
                "numberOfPackages": 0,
                "weight": 0,
                "cube": 0,
                "timeToNext": 0,
                "distanceToNext": 0,
                "departureTime": 0
              }
            ],
            "destinations": [],
            "vehicles": [
              {
                "id": 139812,
                "type": 0,
                "status": 0,
                "name": "Car vehicle",
                "manufacturer": "",
                "model": "",
                "fuelType": 2,
                "lastPosition": [
                  2147483647,
                  2147483647
                ],
                "consumption": 6.5,
                "plate": "",
                "maxLoadWeight": 60,
                "maxLoadCube": 50,
                "height": 0,
                "width": 0,
                "weight": 0,
                "length": 0,
                "axleLoad": 0,
                "fixedCost": 0,
                "costPerHour": 420,
                "startTime": 1439,
                "endTime": 1439,
                "availableBreaks": []
              }
            ],
            "vehiclesConstraints": [
              {
                "fuelPrice": 1.0700000524520874,
                "startDate": 1596758400000,
                "maxNumberOfPackages": 53,
                "minNumberOfOrders": 0,
                "maxNumberOfOrders": 99999999,
                "minDistance": 0,
                "maxDistance": 100000000,
                "maxRevenue": 85
              }
            ],
            "configurationParameters": {
              "name": "Paris - test optimization",
              "ignoreTimeWindow": false,
              "allowDroppingOrders": false,
              "groupingOrders": false,
              "balancedRoutes": 0,
              "optimizationCriterion": 0,
              "arrangeCriterion": 0,
              "optimizationQuality": 2,
              "maxTimeToOptimize": 300,
              "maxWaitTime": 18000,
              "routeType": 0,
              "restrictions": 0,
              "distanceUnit": 0,
              "orderSequenceOptions": []
            },
            "creationTimestamp": 1744096603789,
            "matrixBuildType": 1
          },
          "route": {
            "id": 255145,
            "optimizationId": 139950,
            "configurationParameters": {
              "name": "Paris - test optimization",
              "ignoreTimeWindow": false,
              "allowDroppingOrders": false,
              "groupingOrders": false,
              "balancedRoutes": 0,
              "optimizationCriterion": 0,
              "arrangeCriterion": 0,
              "optimizationQuality": 2,
              "maxTimeToOptimize": 300,
              "maxWaitTime": 18000,
              "routeType": 0,
              "restrictions": 0,
              "distanceUnit": 0,
              "orderSequenceOptions": []
            },
            "vehicleConstraints": {
              "fuelPrice": 1.0700000524520874,
              "startDate": 1596758400000,
              "maxNumberOfPackages": 53,
              "minNumberOfOrders": 0,
              "maxNumberOfOrders": 99999999,
              "minDistance": 0,
              "maxDistance": 100000000,
              "maxRevenue": 85
            },
            "rideStatus": 1,
            "vehicle": {
              "id": 139812,
              "type": 0,
              "status": 0,
              "name": "Car vehicle",
              "manufacturer": "",
              "model": "",
              "fuelType": 2,
              "lastPosition": [
                2147483647,
                2147483647
              ],
              "consumption": 6.5,
              "plate": "",
              "maxLoadWeight": 60,
              "maxLoadCube": 50,
              "height": 0,
              "width": 0,
              "weight": 0,
              "length": 0,
              "axleLoad": 0,
              "fixedCost": 0,
              "costPerHour": 420,
              "startTime": 1439,
              "endTime": 1439,
              "availableBreaks": []
            },
            "departure": {
              "depotId": 0,
              "alias": "Departure1",
              "location": [
                48.870569,
                2.356448
              ],
              "address": {
                "country": "France",
                "state": "",
                "county": "Nouvelle-Aquitaine",
                "city": "Poitiers",
                "postalCode": "86000",
                "streetName": "Boulevard Chasseigne",
                "streetNumber": "34"
              },
              "matchedLocation": [
                2147483647,
                2147483647
              ],
              "numberOfPackages": 0,
              "weight": 0,
              "cube": 0,
              "timeToNext": 0,
              "distanceToNext": 0,
              "departureTime": 0
            },
            "destination": {
              "depotId": 0,
              "alias": "Departure2",
              "address": {
                "country": "France",
                "state": "",
                "county": "Nouvelle-Aquitaine",
                "city": "Poitiers",
                "postalCode": "86000",
                "streetName": "Boulevard Chasseigne",
                "streetNumber": "34"
              },
              "location": [
                48.82674,
                2.342116
              ],
              "matchedLocation": [
                48.82679375,
                2.3420853125
              ],
              "arrivalTime": 1596783691000,
              "traveledDistance": 0.6638350486755371
            },
            "shape": "mn_iH_mhMCVuGuBQIy@s@SDOLIxFzAOlAIfHJJi@mAa@BW",
            "creationTimestamp": 1744096606089,
            "neededFuel": 0.04314928129315376,
            "matrixBuildType": 1,
            "price": 0.04616973176598549,
            "totalWaitTime": 0,
            "totalServiceTime": 0,
            "orders": [
              {
                "orderInfo": {
                  "id": 933799,
                  "creationTimestamp": 1744096603223,
                  "customerInfo": {
                    "id": 1839506,
                    "alias": "",
                    "firstName": "",
                    "lastName": "",
                    "address": {
                      "country": "",
                      "state": "",
                      "county": "",
                      "city": "",
                      "postalCode": "",
                      "streetName": "",
                      "streetNumber": ""
                    },
                    "email": "c1@yahoo.com",
                    "phoneNumber": "+12025550181",
                    "location": [
                      48.827327,
                      2.342267
                    ],
                    "customData": ""
                  },
                  "location": [
                    48.827327,
                    2.342267
                  ],
                  "alias": "",
                  "firstName": "",
                  "lastName": "",
                  "address": {
                    "country": "",
                    "state": "",
                    "county": "",
                    "city": "",
                    "postalCode": "",
                    "streetName": "",
                    "streetNumber": ""
                  },
                  "phoneNumber": "+12025550181",
                  "customData": "",
                  "type": 0,
                  "status": 0,
                  "state": 1,
                  "priority": 0,
                  "numberOfPackages": 0,
                  "weight": 0,
                  "cube": 0,
                  "revenue": 0,
                  "timeWindow": [
                    420,
                    1086
                  ],
                  "serviceTime": 0,
                  "depotId": 0
                },
                "matchedLocation": [
                  48.82734625,
                  2.3421875
                ],
                "actualLocation": [
                  0,
                  0
                ],
                "indexInRoute": 0,
                "indexInOptimization": 1,
                "arrivalTime": 1596783612000,
                "timeToNextOrder": 79,
                "waitTime": 0,
                "numberOfPackagesAtArrival": 0,
                "collectedNumberOfPackages": 0,
                "deliveredNumberOfPackages": 0,
                "weightAtArrival": 0,
                "collectedWeight": 0,
                "deliveredWeight": 0,
                "cubeAtArrival": 0,
                "collectedCube": 0,
                "deliveredCube": 0.07019499689340591,
                "traveledDistance": 0.5936400294303894,
                "distanceToNextOrder": 0,
                "revenueAtArrival": 0
              }
            ],
            "breaks": 91
          }
        }
      ]
    }
  ]
}

```

```json
{
  "history": [
    {
      "order": {
        "id": 0,
        "creationTimestamp": 0,
        "customerInfo": {
          "id": 0,
          "alias": "string",
          "firstName": "string",
          "lastName": "string",
          "address": {
            "country": "string",
            "state": "string",
            "county": "string",
            "city": "string",
            "postalCode": "string",
            "streetName": "string",
            "streetNumber": "string",
            "extra": "string"
          },
          "email": "string",
          "phoneNumber": "string",
          "location": [
            0,
            0
          ],
          "customData": "string"
        },
        "location": [
          0,
          0
        ],
        "alias": "string",
        "firstName": "string",
        "lastName": "string",
        "address": {
          "country": "string",
          "state": "string",
          "county": "string",
          "city": "string",
          "postalCode": "string",
          "streetName": "string",
          "streetNumber": "string",
          "extra": "string"
        },
        "phoneNumber": "string",
        "customData": "string",
        "type": 0,
        "status": 0,
        "state": 1,
        "priority": 0,
        "numberOfPackages": 0,
        "weight": 0,
        "cube": 0,
        "revenue": 0,
        "timeWindow": [
          0,
          0
        ],
        "serviceTime": 0,
        "depotId": 0
      },
      "optimizationsAndRoutes": [
        {
          "optimization": {
            "id": 0,
            "orders": {
              "orders": [
                {
                  "id": 0,
                  "creationTimestamp": 0,
                  "customerInfo": {
                    "id": 0,
                    "alias": "string",
                    "firstName": "string",
                    "lastName": "string",
                    "address": {
                      "country": "string",
                      "state": "string",
                      "county": "string",
                      "city": "string",
                      "postalCode": "string",
                      "streetName": "string",
                      "streetNumber": "string",
                      "extra": "string"
                    },
                    "email": "string",
                    "phoneNumber": "string",
                    "location": [
                      0,
                      0
                    ],
                    "customData": "string"
                  },
                  "location": [
                    0,
                    0
                  ],
                  "alias": "string",
                  "firstName": "string",
                  "lastName": "string",
                  "address": {
                    "country": "string",
                    "state": "string",
                    "county": "string",
                    "city": "string",
                    "postalCode": "string",
                    "streetName": "string",
                    "streetNumber": "string",
                    "extra": "string"
                  },
                  "phoneNumber": "string",
                  "customData": "string",
                  "type": 0,
                  "status": 0,
                  "state": 1,
                  "priority": 0,
                  "numberOfPackages": 0,
                  "weight": 0,
                  "cube": 0,
                  "revenue": 0,
                  "timeWindow": [
                    0,
                    0
                  ],
                  "serviceTime": 0,
                  "depotId": 0
                }
              ]
            },
            "departures": [
              {
                "depotId": 0,
                "alias": "string",
                "location": [
                  0,
                  0
                ],
                "address": {
                  "country": "string",
                  "state": "string",
                  "county": "string",
                  "city": "string",
                  "postalCode": "string",
                  "streetName": "string",
                  "streetNumber": "string",
                  "extra": "string"
                },
                "matchedLocation": [
                  0,
                  0
                ],
                "numberOfPackages": 0,
                "weight": 0,
                "cube": 0,
                "timeToNext": 0,
                "distanceToNext": 0,
                "departureTime": 0
              }
            ],
            "destinations": [
              {
                "alias": "string",
                "location": [
                  0,
                  0
                ],
                "address": {
                  "country": "string",
                  "state": "string",
                  "county": "string",
                  "city": "string",
                  "postalCode": "string",
                  "streetName": "string",
                  "streetNumber": "string",
                  "extra": "string"
                },
                "matchedLocation": [
                  0,
                  0
                ],
                "traveledDistance": 0,
                "arrivalTime": 0
              }
            ],
            "vehicles": {
              "vehicles": [
                {
                  "id": 0,
                  "type": 0,
                  "status": 0,
                  "name": "string",
                  "manufacturer": "string",
                  "model": "string",
                  "fuelType": 0,
                  "lastPosition": [
                    0,
                    0
                  ],
                  "consumption": 0,
                  "plate": "string",
                  "maxLoadWeight": 0,
                  "maxLoadCube": 0,
                  "height": 0,
                  "width": 0,
                  "weight": 0,
                  "length": 0,
                  "axleLoad": 0,
                  "fixedCost": 0,
                  "costPerHour": 0,
                  "startTime": 0,
                  "endTime": 0,
                  "availableBreaks": []
                }
              ]
            },
            "vehiclesConstraints": [
              {
                "fuelPrice": 0,
                "startDate": 0,
                "maxNumberOfPackages": 0,
                "minNumberOfOrders": 0,
                "maxNumberOfOrders": 0,
                "minDistance": 0,
                "maxDistance": 0,
                "maxRevenue": 0
              }
            ],
            "configurationParameters": {
              "name": "string",
              "ignoreTimeWindow": false,
              "allowDroppingOrders": false,
              "groupingOrders": false,
              "balancedRoutes": 0,
              "optimizationCriterion": 0,
              "arrangeCriterion": 0,
              "optimizationQuality": 0,
              "maxTimeToOptimize": 0,
              "maxWaitTime": 0,
              "routeType": 0,
              "restrictions": 0,
              "distanceUnit": 0,
              "orderSequenceOptions": []
            },
            "creationTimestamp": 0,
            "matrixBuildType": 1
          },
          "routes": [
            {
              "id": 0,
              "optimizationId": 0,
              "configurationParameters": {
                "name": "string",
                "ignoreTimeWindow": false,
                "allowDroppingOrders": false,
                "groupingOrders": false,
                "balancedRoutes": 0,
                "optimizationCriterion": 0,
                "arrangeCriterion": 0,
                "optimizationQuality": 0,
                "maxTimeToOptimize": 0,
                "maxWaitTime": 0,
                "routeType": 0,
                "restrictions": 0,
                "distanceUnit": 0,
                "orderSequenceOptions": []
              },
              "vehicleConstraints": [
                {
                  "fuelPrice": 0,
                  "startDate": 0,
                  "maxNumberOfPackages": 0,
                  "minNumberOfOrders": 0,
                  "maxNumberOfOrders": 0,
                  "minDistance": 0,
                  "maxDistance": 0,
                  "maxRevenue": 0
                }
              ],
              "rideStatus": 0,
              "vehicle": {
                "id": 0,
                "type": 0,
                "status": 0,
                "name": "string",
                "manufacturer": "string",
                "model": "string",
                "fuelType": 0,
                "lastPosition": [
                  0,
                  0
                ],
                "consumption": 0,
                "plate": "string",
                "maxLoadWeight": 0,
                "maxLoadCube": 0,
                "height": 0,
                "width": 0,
                "weight": 0,
                "length": 0,
                "axleLoad": 0,
                "fixedCost": 0,
                "costPerHour": 0,
                "startTime": 0,
                "endTime": 0,
                "availableBreaks": []
              },
              "departure": {
                "depotId": 0,
                "alias": "string",
                "location": [
                  0,
                  0
                ],
                "address": {
                  "country": "string",
                  "state": "string",
                  "county": "string",
                  "city": "string",
                  "postalCode": "string",
                  "streetName": "string",
                  "streetNumber": "string",
                  "extra": "string"
                },
                "matchedLocation": [
                  0,
                  0
                ],
                "numberOfPackages": 0,
                "weight": 0,
                "cube": 0,
                "timeToNext": 0,
                "distanceToNext": 0,
                "departureTime": 0
              },
              "destination": {
                "alias": "string",
                "location": [
                  0,
                  0
                ],
                "address": {
                  "country": "string",
                  "state": "string",
                  "county": "string",
                  "city": "string",
                  "postalCode": "string",
                  "streetName": "string",
                  "streetNumber": "string",
                  "extra": "string"
                },
                "matchedLocation": [
                  0,
                  0
                ],
                "traveledDistance": 0,
                "arrivalTime": 0
              },
              "shape": "string",
              "creationTimestamp": 0,
              "neededFuel": 0,
              "matrixBuildType": 1,
              "price": 0,
              "totalWaitTime": 0,
              "totalServiceTime": 0,
              "orders": {
                "orders": [
                  {
                    "id": 0,
                    "creationTimestamp": 0,
                    "customerInfo": {
                      "id": 0,
                      "alias": "string",
                      "firstName": "string",
                      "lastName": "string",
                      "address": {
                        "country": "string",
                        "state": "string",
                        "county": "string",
                        "city": "string",
                        "postalCode": "string",
                        "streetName": "string",
                        "streetNumber": "string",
                        "extra": "string"
                      },
                      "email": "string",
                      "phoneNumber": "string",
                      "location": [
                        0,
                        0
                      ],
                      "customData": "string"
                    },
                    "location": [
                      0,
                      0
                    ],
                    "alias": "string",
                    "firstName": "string",
                    "lastName": "string",
                    "address": {
                      "country": "string",
                      "state": "string",
                      "county": "string",
                      "city": "string",
                      "postalCode": "string",
                      "streetName": "string",
                      "streetNumber": "string",
                      "extra": "string"
                    },
                    "phoneNumber": "string",
                    "customData": "string",
                    "type": 0,
                    "status": 0,
                    "state": 1,
                    "priority": 0,
                    "numberOfPackages": 0,
                    "weight": 0,
                    "cube": 0,
                    "revenue": 0,
                    "timeWindow": [
                      0,
                      0
                    ],
                    "serviceTime": 0,
                    "depotId": 0
                  }
                ]
              },
              "breaks": [],
              "totalTime": 0,
              "totalDistance": 0
            }
          ]
        }
      ]
    }
  ]
}

```

***
