Versioning

Deliveroo offers a versioned API, enabling APIs to be improved while preventing existing integrations from breaking.

/api/v1/...

The URL of every API call includes an explicit version as a path segment.

Backwards Compatibility

We are committed to maintaining backward compatibility while developing the Deliveroo API. The APIs may grow, acquiring new features or deprecating outdated ones, but not in a way that breaks existing integrations.

Applications written to consume the Deliveroo API should be able to handle changes gracefully. You can expect changes such as new fields added to response bodies or headers, optional fields to request bodies and headers, optional request query parameters, additional values to existing request and response enums, or make validation less strict. We will not add mandatory request fields, headers, or parameters or make validation more strict.