---
updatedAt: 2026-05-19T20:38:09.000Z
agentTools:
  projectIndex: https://developers.bringg.com/llms.txt
---

# Get All Vehicle Profiles

Use this endpoint to retrieve a list of all vehicle profiles for your merchant.

Note: This endpoint doesn't require input parameters.

<details>
  <summary className="APISectionHeader-heading4MUMLbp4_nLs">Response (Output) Params</summary>

  <Table>
  <thead>
    <tr>
      <th>
        **Parameter**
      </th>

      <th>
        **Description**
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        \*`success`\*\*<br /><sub>boolean</sub>
      </td>

      <td>
        Indicates whether the service completed successfully.

        * *false*\* - the service failed.
        * *true*\* - the service succeeded
      </td>
    </tr>

    <tr>
      <td>
        \*`message`\*\*<br /><sub>string</sub>
      </td>

      <td>
        If an error occurred, a message indicating the error is included.
      </td>
    </tr>

    <tr>
      <td>
        \*`rc`\*\*<br /><sub>integer</sub>
      </td>

      <td>
        If an error occurred, the return code is included.
      </td>
    </tr>

    <tr>
      <td>
        \*`can_attach_trailer`\*\*<br /><sub>boolean</sub>
      </td>

      <td>
        A flag specifying whether or not vehicles with this profile can attach to trailers.
      </td>
    </tr>

    <tr>
      <td>
        \*`cost_per_shift`\*\*<br /><sub>string</sub>
      </td>

      <td>
        A relative cost allocated to vehicles using this profile that is used in some types of route optimization. Serves to reduce the number of vehicles used in a given optimization.
      </td>
    </tr>

    <tr>
      <td>
        \*`created_at`\*\*<br /><sub>datetime</sub>
      </td>

      <td>
        The timestamp when the vehicle profile was created. This is in UTC and the format is "%Y-%m-%dT%H:%M:%S%z".
      </td>
    </tr>

    <tr>
      <td>
        \*`default_for_merchant`\*\*<br /><sub>boolean</sub>
      </td>

      <td>
        A flag indicating whether this vehicle profile is the default for the merchant.
      </td>
    </tr>

    <tr>
      <td>
        \*`external_id`\*\*<br /><sub>string</sub>
      </td>

      <td>
        Your system's ID for this vehicle profile.
      </td>
    </tr>

    <tr>
      <td>
        \*`handling_units`\*\*<br /><sub>json</sub>
      </td>

      <td>
        Used to specify the maximum capacity in custom units for vehicles using this vehicle profile.
      </td>
    </tr>

    <tr>
      <td>
        \*`height`\*\*<br /><sub>integer</sub>
      </td>

      <td>
        The internal height capacity (cm) of a vehicle with this profile. Used when determining vehicle volume.
      </td>
    </tr>

    <tr>
      <td>
        \*`id`\*\*<br /><sub>integer</sub>
      </td>

      <td>
        The Bringg ID for this vehicle profile.
      </td>
    </tr>

    <tr>
      <td>
        \*`is_green`\*\*<br /><sub>boolean</sub>
      </td>

      <td>
        A vehicle using this profile is considered a "Green" vehicle as it approaches net zero carbon emissions.
      </td>
    </tr>

    <tr>
      <td>
        \*`is_trailer`\*\*<br /><sub>boolean</sub>
      </td>

      <td>
        A flag specifying whether or not vehicles with this profile are considered trailers.
      </td>
    </tr>

    <tr>
      <td>
        \*`length`\*\*<br /><sub>integer</sub>
      </td>

      <td>
        The internal length capacity (cm) of the vehicle with this profile. Used when determining vehicle volume.
      </td>
    </tr>

    <tr>
      <td>
        \*`max_total_weight`\*\*<br /><sub>integer</sub>
      </td>

      <td>
        The maximum weight capacity a vehicles with this profile can carry at a time.
      </td>
    </tr>

    <tr>
      <td>
        \*`max_route_distance_km`\*\*<br /><sub>integer</sub>
      </td>

      <td>
        The longest distance that a vehicle using this profile can serve on a single route, in kilometers.
      </td>
    </tr>

    <tr>
      <td>
        \*`max_vehicle_distance_km`\*\*<br /><sub>integer</sub>
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        \*`maximum_tasks_per_route`\*\*<br /><sub>integer</sub>
      </td>

      <td>
        The maximum number of orders that a vehicle using this profile can transport at a time.
      </td>
    </tr>

    <tr>
      <td>
        \*`speed_factor`\*\*<br /><sub>float</sub>
      </td>

      <td>

      </td>
    </tr>

    <tr>
      <td>
        \*`title`\*\*<br /><sub>string</sub>
      </td>

      <td>
        Your name for the vehicle profile. This is how the vehicle profile appears in the Bringg UI.
      </td>
    </tr>

    <tr>
      <td>
        \*`transport_time_minutes`\*\*<br /><sub>integer</sub>
      </td>

      <td>
        The maximum duration (minutes) you set for a route to last for a vehicle using this profile.
      </td>
    </tr>

    <tr>
      <td>
        \*`updated_at`\*\*<br /><sub>datetime</sub>
      </td>

      <td>
        The last date and time this vehicle profile was updated.  This is in UTC and the format is "%Y-%m-%dT%H:%M:%S%z".
      </td>
    </tr>

    <tr>
      <td>
        \*`vehicle_category`\*\*<br /><sub>string</sub>
      </td>

      <td>
        The type of vehicle (car, bicycle, or type of truck) using this profile.
      </td>
    </tr>

    <tr>
      <td>
        \*`vehicle_category_id`\*\*<br /><sub>integer</sub>
      </td>

      <td>
        The Bringg ID for the type of vehicle (car, bicycle, or type of truck) using this profile.
      </td>
    </tr>

    <tr>
      <td>
        \*`width`\*\*<br /><sub>integer</sub>
      </td>

      <td>
        The internal width capacity (cm) of a vehicle with this profile. Used when determining vehicle volume.
      </td>
    </tr>
  </tbody>
</Table>

</details>

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "services-api-settings",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://developer-api.bringg.com/services"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/SHr5XT6Y/service_uuid1/service_uuid2": {
      "get": {
        "summary": "Get All Vehicle Profiles",
        "description": "Use this endpoint to retrieve a list of all vehicle profiles for your merchant.",
        "operationId": "get_vehicle_types",
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": {
                      "vehicle_types": [
                        {
                          "id": 1001,
                          "title": "Delivery Van",
                          "description": "Delivery Van",
                          "external_id": "delivery_van",
                          "can_attach_trailer": false,
                          "is_trailer": false,
                          "cost_per_shift": 10,
                          "default_for_merchant": null,
                          "height": 1000,
                          "width": 1000,
                          "length": 1000,
                          "max_total_weight": 1000,
                          "maximum_tasks_per_route": 199,
                          "speed_factor": 1.1,
                          "is_green": null,
                          "max_route_distance_km": null,
                          "max_vehicle_distance_km": null,
                          "transport_time_minutes": null,
                          "handling_units": {},
                          "created_at": "2026-05-19T15:00:00.000Z",
                          "updated_at": "2026-05-19T16:00:00.000Z",
                          "vehicle_category_id": null,
                          "route_cost_calculation_type": null,
                          "route_cost_calculation_configuration": null,
                          "vehicle_category": "car"
                        },
                        {
                          "id": 1002,
                          "title": "Cost per Minute",
                          "description": null,
                          "external_id": "CPM",
                          "can_attach_trailer": false,
                          "is_trailer": null,
                          "cost_per_shift": 0,
                          "default_for_merchant": null,
                          "height": null,
                          "width": null,
                          "length": null,
                          "max_total_weight": 100,
                          "maximum_tasks_per_route": 10,
                          "speed_factor": null,
                          "is_green": null,
                          "max_route_distance_km": null,
                          "max_vehicle_distance_km": null,
                          "transport_time_minutes": null,
                          "handling_units": {},
                          "created_at": "2026-05-19T15:00:00.000Z",
                          "updated_at": "2026-05-19T16:00:00.000Z",
                          "vehicle_category_id": null,
                          "route_cost_calculation_type": 1,
                          "route_cost_calculation_configuration": {
                            "overall_cost_per_minute": 2
                          },
                          "vehicle_category": "truck"
                        },
                        {
                          "id": 1003,
                          "title": "Truck",
                          "description": "Truck",
                          "external_id": "truck",
                          "can_attach_trailer": false,
                          "is_trailer": false,
                          "cost_per_shift": 20,
                          "default_for_merchant": false,
                          "height": 1000,
                          "width": 1000,
                          "length": 1000,
                          "max_total_weight": 20000,
                          "maximum_tasks_per_route": 200,
                          "speed_factor": null,
                          "is_green": null,
                          "max_route_distance_km": null,
                          "max_vehicle_distance_km": null,
                          "transport_time_minutes": null,
                          "handling_units": {},
                          "created_at": "2026-05-19T15:00:00.000Z",
                          "updated_at": "2026-05-19T16:00:00.000Z",
                          "vehicle_category_id": null,
                          "route_cost_calculation_type": 2,
                          "route_cost_calculation_configuration": {
                            "order_cost_percentage": 25
                          },
                          "vehicle_category": "truck"
                        },
                        {
                          "id": 1004,
                          "title": "Trailer",
                          "description": "Trailer",
                          "external_id": "trailer",
                          "can_attach_trailer": false,
                          "is_trailer": true,
                          "cost_per_shift": 0,
                          "default_for_merchant": false,
                          "height": null,
                          "width": null,
                          "length": null,
                          "max_total_weight": 20000,
                          "maximum_tasks_per_route": null,
                          "speed_factor": null,
                          "is_green": null,
                          "max_route_distance_km": 1000,
                          "max_vehicle_distance_km": 1000,
                          "transport_time_minutes": null,
                          "handling_units": {},
                          "created_at": "2026-05-19T15:00:00.000Z",
                          "updated_at": "2026-05-19T16:00:00.000Z",
                          "vehicle_category_id": null,
                          "route_cost_calculation_type": 3,
                          "route_cost_calculation_configuration": {
                            "cost_per_km": 0,
                            "cost_per_tos": 0,
                            "cost_per_stop": 10,
                            "cost_per_route": 0,
                            "cost_per_minute_driving": 0,
                            "cost_per_minute_waiting": 0
                          },
                          "vehicle_category": "truck"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "vehicle_types": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "integer",
                            "example": 1001,
                            "default": 0
                          },
                          "title": {
                            "type": "string",
                            "example": "Delivery Van"
                          },
                          "description": {
                            "type": "string",
                            "example": "Delivery Van"
                          },
                          "external_id": {
                            "type": "string",
                            "example": "delivery_van"
                          },
                          "can_attach_trailer": {
                            "type": "boolean",
                            "example": false,
                            "default": true
                          },
                          "is_trailer": {
                            "type": "boolean",
                            "example": false,
                            "default": true
                          },
                          "cost_per_shift": {
                            "type": "integer",
                            "example": 10,
                            "default": 0
                          },
                          "default_for_merchant": {
                            "type": "boolean"
                          },
                          "height": {
                            "type": "integer",
                            "example": 1000,
                            "default": 0,
                            "format": "int32"
                          },
                          "width": {
                            "type": "integer",
                            "example": 1000,
                            "default": 0,
                            "format": "int32"
                          },
                          "length": {
                            "type": "integer",
                            "example": 1000,
                            "default": 0,
                            "format": "int32"
                          },
                          "max_total_weight": {
                            "type": "integer",
                            "example": 1000,
                            "default": 0
                          },
                          "maximum_tasks_per_route": {
                            "type": "integer",
                            "example": 199,
                            "default": 0
                          },
                          "speed_factor": {
                            "type": "number",
                            "example": 1.1,
                            "default": 0
                          },
                          "is_green": {
                            "type": "boolean"
                          },
                          "max_route_distance_km": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "max_vehicle_distance_km": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "transport_time_minutes": {
                            "type": "integer",
                            "format": "int32"
                          },
                          "handling_units": {
                            "type": "object",
                            "properties": {}
                          },
                          "created_at": {
                            "type": "string",
                            "example": "2026-05-19T15:00:00.000Z"
                          },
                          "updated_at": {
                            "type": "string",
                            "example": "2026-05-19T16:00:00.000Z"
                          },
                          "vehicle_category_id": {
                            "type": "integer"
                          },
                          "route_cost_calculation_type": {
                            "type": "integer",
                            "description": "1 = Overall cost per minute\n2 = Order cost percentage\n3 = Cost calculation method"
                          },
                          "route_cost_calculation_configuration": {
                            "type": "object",
                            "properties": {
                              "overall_cost_per_minute": {
                                "type": "number",
                                "format": "double",
                                "description": "Used when route_cost_calculation_type = 1"
                              },
                              "order_cost_percentage": {
                                "type": "number",
                                "format": "double",
                                "description": "Used when route_cost_calculation_type = 2"
                              },
                              "cost_per_km": {
                                "type": "number",
                                "format": "double",
                                "description": "Used when route_cost_calculation_type = 3"
                              },
                              "cost_per_tos": {
                                "type": "number",
                                "format": "double",
                                "description": "Used when route_cost_calculation_type = 3"
                              },
                              "cost_per_stop": {
                                "type": "number",
                                "format": "double",
                                "description": "Used when route_cost_calculation_type = 3"
                              },
                              "cost_per_route": {
                                "type": "number",
                                "format": "double",
                                "description": "Used when route_cost_calculation_type = 3"
                              },
                              "cost_per_minute_driving": {
                                "type": "number",
                                "format": "double",
                                "description": "Used when route_cost_calculation_type = 3"
                              },
                              "cost_per_minute_waiting": {
                                "type": "number",
                                "format": "double",
                                "description": "Used when route_cost_calculation_type = 3"
                              }
                            },
                            "description": "Used when * route_cost_calculation_type * is not null"
                          },
                          "vehicle_category": {
                            "type": "string",
                            "example": "car"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": false,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true
}
```