# Drive API Reference API

**Canonical:** https://apis.io/apis/plugsurfing/drive-api-reference-api/  
**Provider:** Plugsurfing — https://apis.io/providers/plugsurfing/  
**Documentation:** https://developer.plugsurfing.com/llms.txt

Drive API Reference API is one of 2 APIs that [Plugsurfing](https://apis.io/providers/plugsurfing/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Drive API provides comprehensive access to Plugsurfing's charging infrastructure network. It enables you to manage users, charging keys, search for charging locations, handle payments, and control charging sessions.

## Operations (59)

| Method | Path | Summary |
|---|---|---|
| POST | `/drive/v1/users/{userId}/charging-keys/{referenceId}/activate` | Activate a charging key |
| PATCH | `/drive/v1/users/{userId}/charging-keys/{identifier}` | Edit a charging key |
| GET | `/drive/v1/users/{userId}/charging-keys` | Get user's charging keys |
| POST | `/drive/v1/users/{userId}/charging-keys` | Create a charging key |
| POST | `/drive/v1/users/{userId}/charging-keys/plug-and-charge` | Create a Plug&Charge key |
| POST | `/drive/v1/users/{userId}/charging-keys/orders` | Create charging key order |
| GET | `/drive/v1/users/{userId}/charging-keys/orders` | Get list of charging key orders |
| GET | `/drive/v1/users/{userId}/charging-keys/orders/{orderId}/receipt` | Get order receipt URL |
| GET | `/drive/v1/charging-keys/orders/configuration` | Get pricing information per country |
| POST | `/drive/v1/charging-keys/reservations` | Reserve a charging key |
| POST | `/drive/v1/geosearch/radius` | Radius search |
| POST | `/drive/v1/geosearch/rectangle` | Rectangle search |
| POST | `/drive/v1/geosearch/route` | Route search |
| GET | `/drive/v1/locations/{locationId}` | Get location by id |
| GET | `/drive/v1/locations/{locationId}/live-data` | Get location live data |
| GET | `/drive/v1/locations/batch` | Batch locations |
| GET | `/drive/v1/locations/operators` | Get list of operators |
| GET | `/drive/v1/users/{userId}/payment-options` | Get user's payment methods |
| POST | `/drive/v1/users/{userId}/payment-options` | Add a new payment method |
| GET | `/drive/v1/users/{userId}/payment-options/stripe-setup-intent` | Get Stripe SetupIntent to confirm a payment method |
| DELETE | `/drive/v1/users/{userId}/payment-options/{id}` | Delete user's payment option |
| GET | `/drive/v1/users/{userId}/prepaid` | Get user's prepaid balance |
| POST | `/drive/v1/users/{userId}/sessions/history` | Get charging session history |
| GET | `/drive/v1/users/{userId}/sessions/{sessionId}` | Get details of a specific charging session |
| GET | `/drive/v1/users/{userId}/sessions/{sessionId}/receipt` | Get a session receipt by session id |
| POST | `/drive/v1/users/{userId}/sessions/start` | Start a remote charging session |
| POST | `/drive/v1/users/{userId}/sessions/{sessionId}/stop` | Stop a remote charging session |
| POST | `/drive/v1/users/{userId}/sessions/{sessionId}/payments/retry` | Retry session payment |
| POST | `/drive/v1/users/{userId}/user-groups/{groupId}` | Add user to user group |
| DELETE | `/drive/v1/users/{userId}/user-groups/{groupId}` | Remove user from user group |
| POST | `/drive/v1/users/{userId}/vouchers/{code}/redeem` | Redeem a voucher code |
| POST | `/drive/v1/users` | Create user |
| GET | `/drive/v1/users/{userId}` | Read user details |
| PATCH | `/drive/v1/users/{userId}` | Update user details |
| DELETE | `/drive/v1/users/{userId}` | Remove user |
| GET | `/emp/v1/charging-keys` | Get charging keys |
| POST | `/emp/v1/charging-keys` | Create a charging key |
| PUT | `/emp/v1/charging-keys/{keyIdentifier}/rename` | Rename a charging key |
| PUT | `/emp/v1/charging-keys/{keyIdentifier}/enable` | Enable charging key |
| PUT | `/emp/v1/charging-keys/{keyIdentifier}/disable` | Disable charging key |
| PUT | `/emp/v1/charging-keys/{keyIdentifier}/transfer` | Transfer a charging key |
| POST | `/emp/v1/geosearch/radius` | Search locations around a point |
| POST | `/emp/v1/geosearch/rectangle` | Search locations within a rectangle |
| POST | `/emp/v1/geosearch/route` | Search for locations along a route |
| GET | `/emp/v1/locations/{locationId}` | Get location by id |
| GET | `/emp/v1/locations/{locationId}/live-data` | Get location live data |
| GET | `/emp/v1/locations/batch` | Get batch of locations |
| GET | `/emp/v1/orders` | Fetch charging key orders |
| POST | `/emp/v1/orders` | Create a fleet charging key order |
| POST | `/emp/v1/orders/{orderId}/assign` | Mark an order as 'Assigned' |
| GET | `/emp/v1/products` | List available products |
| GET | `/emp/v1/payment-options/stripe/publishable-api-key` | Get Stripe publishable API key |
| POST | `/emp/v1/sessions/start` | Start a remote session |
| POST | `/emp/v1/sessions/{sessionId}/stop` | Stop a remote session |
| GET | `/emp/v1/sessions/{sessionId}/receipt` | Get a session receipt by session id |
| GET | `/emp/v1/sessions/{sessionId}` | Get session by id |
| POST | `/emp/v1/fleets` | Create a fleet |
| PUT | `/emp/v1/fleets/{fleetId}/rename` | Rename a fleet |
| GET | `/emp/v1/fleets/{fleetId}/invitation` | Get fleet invitation codes |

## Machine-readable artifacts (7)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/plugsurfing/refs/heads/main/openapi/_original/plugsurfing-reference-openapi.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/plugsurfing/refs/heads/main/json-schema/plugsurfing-location-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/plugsurfing/refs/heads/main/json-schema/plugsurfing-session-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/plugsurfing/refs/heads/main/json-schema/plugsurfing-emp-charging-key-orders-product-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/plugsurfing/refs/heads/main/json-schema/plugsurfing-charging-key-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/plugsurfing/refs/heads/main/json-schema/plugsurfing-prepaid-balance-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/plugsurfing/refs/heads/main/json-schema/plugsurfing-emp-charging-key-post-request-schema.json

## Other Plugsurfing APIs (1)

- [Drive API](https://apis.io/apis/plugsurfing/drive-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/plugsurfing/drive-api-reference-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/plugsurfing/.