API v1 — single host

September 2026

Breaking change

Every legacy base URL and path stops working. The per-service hosts (payment, idp, warranty, …) and the /api prefix are replaced by one host, https://api.openhive.eu, with every path under /v1.

Eighteen endpoints are renamed along the way, and ids become uids. Go through the checklist before switching.

What changes

• One host for every service: https://api.openhive.eu.
• Paths are versioned and grouped by service. What lived under /api now lives under /v1 followed by the service name. Authentication resources are the exception and carry no service segment.
• Identifiers: id becomes uid. Every resource is now identified by a uid instead of an id — in responses and in URLs. Check every place where your integration reads or sends an identifier.

Same call, before and after

# before
POST https://payment.openhive.eu/api/payment-sessions

# after
POST https://api.openhive.eu/v1/payment/sessions

Base URLs

Service	Legacy base URL	New base URL
Authentication (IDP)	https://idp.openhive.eu/api	https://api.openhive.eu/v1
Payment	https://payment.openhive.eu/api	https://api.openhive.eu/v1/payment
Warranty	https://warranty.openhive.eu/api	https://api.openhive.eu/v1/warranty
Diagnostic	https://diagnostic.openhive.eu/api	https://api.openhive.eu/v1/diagnostic
Additional Products	https://additional-product.openhive.eu/api	https://api.openhive.eu/v1/additional-product
Inventory	https://inventory.preprod.openhive.eu/api	https://api.openhive.eu/v1/inventory

Renamed endpoints

Beyond the host and the prefix, these paths change name.

Payment

Method	Legacy	New
POST	/api/payment-sessions	/v1/payment/sessions
GET	/api/payment-methods	/v1/payment/methods
GET	/api/payments/{uid}	/v1/payment/transactions/{uid}
GET	/api/payments/{uid}/iban	/v1/payment/transactions/{uid}/iban
POST	/api/onboarding/{provider}/link	/v1/payment/onboarding/{provider}/links

Warranty

Method	Legacy	New
POST	/api/warranty/session	/v1/warranty/sessions

Diagnostic

Method	Legacy	New
GET	/api/soh-diagnostics	/v1/diagnostic/soh-reports
GET	/api/soh-diagnostics/{uid}	/v1/diagnostic/soh-reports/{uid}
POST	/api/soh-diagnostics/sandbox	/v1/diagnostic/soh-reports/sandbox
POST	/api/soh/diagnostics	/v1/diagnostic/soh-requests

Additional Products

Method	Legacy	New
GET	/api/additional-products	/v1/additional-product/products
POST	/api/additional-products	/v1/additional-product/products
GET	/api/additional-products/{uid}	/v1/additional-product/products/{uid}
PATCH	/api/additional-products/{uid}	/v1/additional-product/products/{uid}
DELETE	/api/additional-products/{uid}	/v1/additional-product/products/{uid}
PATCH	/api/additional-products/{uid}/sold	/v1/additional-product/products/{uid}/sold

Inventory

Inventory also leaves its own host (inventory.preprod.openhive.eu) for the single host, under /v1/inventory.

Method	Legacy	New
GET	/api/vehicle_partials	/v1/inventory/vehicle-partials

OpenAPI documentation

Legacy	New
/doc	/v1/doc
/<service>/doc	/v1/<service>/doc

Migration checklist

1. Point your client at the single host: https://api.openhive.eu.
2. Move every path from /api to /v1 followed by the service name — plain /v1 for authentication.
3. Apply the renames above, and switch every identifier from id to uid.