> For the complete documentation index, see [llms.txt](https://docs.shippify.co/developers/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shippify.co/developers/en/shippify-api/routes/create-route.md).

# Create route

## Route creation

> Endpoint that allows creating routes from given deliveries.

```json
{"openapi":"3.0.0","info":{"title":"Shippify Api","version":"1.0.0"},"servers":[{"url":"https://api.shippify.co","description":"Development server"}],"security":[{"Basic_Auth":[]}],"components":{"securitySchemes":{"Basic_Auth":{"type":"http","scheme":"basic"}},"schemas":{"createRoutes":{"successfulResponse":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"data":{"type":"object","description":"Information of the additional processes created (in case the delivery belongs to a route)","properties":{"jobs":{"description":"Identifier of the external process created","type":"string"}}}}},"request":{"type":"object","required":["routes","iterations"],"properties":{"routes":{"description":"Set of deliveries, each item will create a route","type":"array","items":{"required":["deliveries"],"type":"object","properties":{"deliveries":{"type":"array","description":"Identifiers of the deliveries to be routed. Minimum 2 deliveries.","items":{"type":"string"}}}}},"iterations":{"description":"Indicates the level of optimization with which the route will be created","type":"integer","minimum":1,"maximum":10}}}},"Unauthenticated":{"properties":{"code":{"type":"string"},"message":{"type":"string"}},"type":"object"}}},"paths":{"/v1/routes/create":{"post":{"tags":["Creation, Routes"],"summary":"Route creation","description":"Endpoint that allows creating routes from given deliveries.","responses":{"200":{"description":"Successful operation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createRoutes/successfulResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Unauthenticated"}}}}},"requestBody":{"description":"Here goes the description","content":{"application/json":{"schema":{"$ref":"#/components/schemas/createRoutes/request"}}}}}}}}
```

## Use cases 

<details>

<summary>Create routes with a specific order of deliveries</summary>

```json
{
    "routes": [
        {
            "deliveries": [
              "t-pruaas-4973",
              "t-pruaas-4972"
            ]
        }
    ],
    "iterations": 1
}
```

</details>

<details>

<summary>Create routes with medium optimization based on entered deliveries</summary>

```json
{
    "routes": [
        {
            "deliveries": [
              "t-pruaas-4973",
              "t-pruaas-4972"
            ]
        }
    ],
    "iterations": 5
}
```

</details>

<details>

<summary>Create routes with high optimization based on entered deliveries</summary>

```json
{
    "routes": [
        {
            "deliveries": [
              "t-pruaas-4973",
              "t-pruaas-4972"
            ]
        }
    ],
    "iterations": 10
}
```

</details>