# Docs

- [Overview](https://docs.roundtrip.ai/docs.md): Integrate EasyRoutes with your systems to import orders, manage routes, dispatch drivers, and react to delivery events.
- [Getting Started](https://docs.roundtrip.ai/docs/getting-started.md): Generate API credentials, authenticate, and make your first EasyRoutes API call.
- [Webhooks Guide](https://docs.roundtrip.ai/docs/webhooks.md): Register webhook endpoints, verify signatures, and receive EasyRoutes events.
- Concepts
  - [Field Masks](https://docs.roundtrip.ai/docs/concepts/field-masks.md): How to use field masks to perform partial updates on EasyRoutes resources.
- API Reference
  - [API Reference](https://docs.roundtrip.ai/docs/api-reference.md): Complete API reference for EasyRoutes
  - Authentication: Use the Authenticate endpoint to obtain an access token with your client ID and secret. Access tokens are required for all other API requests and expire after a specified duration.
    - [Authenticate](https://docs.roundtrip.ai/docs/api-reference/authentication/post-authenticate.md)
  - Drivers: Drivers endpoints allow you to retrieve information about drivers in your organization. Drivers can be assigned to routes and have different statuses including active, inactive, and archived. Note that invited drivers who haven't completed sign-up are not returned by the API.
    - [List drivers](https://docs.roundtrip.ai/docs/api-reference/drivers/get-drivers.md)
    - [Get driver](https://docs.roundtrip.ai/docs/api-reference/drivers/get-drivers-id.md)
  - Routes: Routes endpoints allow you to manage delivery routes. A route represents a sequence of stops to be completed by a driver, with an optional start and end location. You can list routes and retrieve individual routes by ID.
    - [List routes](https://docs.roundtrip.ai/docs/api-reference/routes/get-routes.md)
    - [Create route](https://docs.roundtrip.ai/docs/api-reference/routes/post-routes.md)
    - [Get route](https://docs.roundtrip.ai/docs/api-reference/routes/get-routes-id.md)
    - [Update route](https://docs.roundtrip.ai/docs/api-reference/routes/patch-routes-routeId.md)
    - [Dispatch route](https://docs.roundtrip.ai/docs/api-reference/routes/post-routes-routeId-dispatch.md)
    - [Undispatch route](https://docs.roundtrip.ai/docs/api-reference/routes/delete-routes-routeId-dispatch.md)
    - [Unassign route driver](https://docs.roundtrip.ai/docs/api-reference/routes/delete-routes-routeId-driver.md)
    - [Assign route driver](https://docs.roundtrip.ai/docs/api-reference/routes/put-routes-routeId-driver.md)
    - [Update route end location](https://docs.roundtrip.ai/docs/api-reference/routes/patch-routes-routeId-end-location.md)
    - [Update route end tasks](https://docs.roundtrip.ai/docs/api-reference/routes/put-routes-routeId-end-tasks.md)
    - [Update route start location](https://docs.roundtrip.ai/docs/api-reference/routes/patch-routes-routeId-start-location.md)
    - [Update route start tasks](https://docs.roundtrip.ai/docs/api-reference/routes/put-routes-routeId-start-tasks.md)
    - [Unassign route vehicle](https://docs.roundtrip.ai/docs/api-reference/routes/delete-routes-routeId-vehicle.md)
    - [Assign route vehicle](https://docs.roundtrip.ai/docs/api-reference/routes/put-routes-routeId-vehicle.md)
  - Stops: Stops endpoints allow you to manage delivery stops in two contexts: route stops (stops actively on a route) and imported stops (a library of stops that can be added to routes). You can import stops from external systems, add them to routes, update stop details, and query which routes contain a specific stop.
    - [Reoptimize route](https://docs.roundtrip.ai/docs/api-reference/stops/post-routes-id-reoptimize.md)
    - [Add route stops](https://docs.roundtrip.ai/docs/api-reference/stops/post-routes-routeId-stops.md)
    - [Delete route stops](https://docs.roundtrip.ai/docs/api-reference/stops/delete-routes-routeId-stops-stopIds.md)
    - [Get route stop](https://docs.roundtrip.ai/docs/api-reference/stops/get-routes-routeId-stops-stopId.md)
    - [Update route stop](https://docs.roundtrip.ai/docs/api-reference/stops/patch-routes-routeId-stops-stopId.md)
    - [Update route stop items](https://docs.roundtrip.ai/docs/api-reference/stops/put-routes-routeId-stops-stopId-items.md)
    - [Update route stop location](https://docs.roundtrip.ai/docs/api-reference/stops/patch-routes-routeId-stops-stopId-location.md)
    - [Reorder route stop](https://docs.roundtrip.ai/docs/api-reference/stops/put-routes-routeId-stops-stopId-position.md)
    - [Update route stop tasks](https://docs.roundtrip.ai/docs/api-reference/stops/put-routes-routeId-stops-stopId-tasks.md)
    - [List imported stops](https://docs.roundtrip.ai/docs/api-reference/stops/get-stops-imports.md)
    - [Import stops](https://docs.roundtrip.ai/docs/api-reference/stops/post-stops-imports.md)
    - [Get imported stop](https://docs.roundtrip.ai/docs/api-reference/stops/get-stops-imports-id.md)
    - [Update imported stop](https://docs.roundtrip.ai/docs/api-reference/stops/patch-stops-imports-id.md)
    - [Delete imported stop](https://docs.roundtrip.ai/docs/api-reference/stops/delete-stops-imports-id.md)
    - [Update imported stop items](https://docs.roundtrip.ai/docs/api-reference/stops/put-stops-imports-id-items.md)
    - [Update imported stop location](https://docs.roundtrip.ai/docs/api-reference/stops/patch-stops-imports-id-location.md)
    - [Get imported stop route info](https://docs.roundtrip.ai/docs/api-reference/stops/get-stops-imports-id-routes.md)
    - [Update imported stop tasks](https://docs.roundtrip.ai/docs/api-reference/stops/put-stops-imports-id-tasks.md)
    - [Get Shopify stop route info](https://docs.roundtrip.ai/docs/api-reference/stops/get-stops-shopify-id-routes.md)
  - Vehicles: Vehicles endpoints allow you to retrieve information about vehicles in your organization and assign or unassign them from routes.
    - [List vehicles](https://docs.roundtrip.ai/docs/api-reference/vehicles/get-vehicles.md)
    - [Get vehicle](https://docs.roundtrip.ai/docs/api-reference/vehicles/get-vehicles-id.md)
  - Webhooks: Webhooks endpoints allow you to subscribe to real-time events from EasyRoutes. You can receive notifications when routes are created or updated, stops are delivered, drivers are added or updated, and more. Each subscription can listen to multiple event topics and send POST requests to your specified URL.
    - [List webhook subscriptions](https://docs.roundtrip.ai/docs/api-reference/webhooks/get-webhooks.md)
    - [Subscribe webhook](https://docs.roundtrip.ai/docs/api-reference/webhooks/post-webhooks.md)
    - [Unsubscribe webhook](https://docs.roundtrip.ai/docs/api-reference/webhooks/delete-webhooks-id.md)
- [API Changelog](https://docs.roundtrip.ai/docs/changelog.md): New features, improvements, and fixes in the EasyRoutes API.