# EcoTransIT World REST-API

## General Information
This is the complete specification of the EcoTransIT World Rest Api <br>
**Please note:** in order to try out the API you need to [contact our team](https://www.ecotransit.org/en/contact/) to get a test account.

## Authorization
If you are already a customer or have a test account see your instance of swagger-ui
https://customer-name.ecotransit.org/swagger-ui (replace _customer-name_ with your company name or the test server name)
for details on authorization and how to send your first request to the REST API! <br>

Version: 2025r4.1.4
License: IVE Legal notice

## Servers

```
https://customer-name.ecotransit.org
```

## Security

### oAuth2AuthorizationCode

This API uses OAuth 2 with the Authorization Code flow.

Type: oauth2

## Download OpenAPI description

[EcoTransIT World REST-API](https://rest-api.ecotransit.world/_spec/apis/OpenApi.yaml)

## calculate transport

calculate Emissions for specified Transport

### calculate Transport from json input

 - [POST /etw-rest/calculateTransport](https://rest-api.ecotransit.world/apis/openapi/calculate-transport/calculatetransport.md): request for emission calculations

### get a google earth kml file

 - [GET /etw-rest/calculateTransport/kml](https://rest-api.ecotransit.world/apis/openapi/calculate-transport/calculatetransportkml.md): generates a google earth kml file of the routing for the provided request uuid

## collection and delivery

calculate Emissions for round trip (milkrun)

### collection and delivery calculation

 - [POST /etw-rest/calculateCollectionAndDelivery](https://rest-api.ecotransit.world/apis/openapi/collection-and-delivery/calculatecollectionanddelivery.md): calculate a collection and delivery round ("milkrun") from json input

## Info

get general Information about the api

### etw-rest-api version

 - [GET /etw-rest/getVersion](https://rest-api.ecotransit.world/apis/openapi/info/getversion.md): Returns the current version of the etw-rest api