Request Quotes

post

https://rest.sandbox.karhoo.com/v2/quotes/

This endpoint will return a list of quotes by the fleets who serve the location. You can either request a trip for a future date-time or ASAP (by leaving the date-time blank).
The response will contain a quote list id and a validity period in seconds (presently the defaults for ASAP and prebooks are 300 and 600 seconds, respectively), this list must be polled via the separate retrieve quotes list endpoint to receive a complete list of quotes.
Please note that whilst the display_address field is marked optional, we strongly recommend providing this where possible to help ensure the best level of service.

Responses

`id` which can be used when calling the quotes/{id} endpoint, to retrieve these quotes.

Language

Credentials

Header

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

*/*

201The request was successful. The backend server will begin to collate quotes from the fleets who operate in the specified area. The response body will contain an id which can be used when calling the quotes/{id} endpoint, to retrieve these quotes.

400Bad Request. The request was invalid.

401Unauthorized. The request requires user authentication (not logged in).

403Forbidden. The credentials provided do not have sufficient authority for this request. Please request access by emailing API Support.

429Error. Too Many Requests. Exceeded the rate limit for requests.

500Internal server error. Something has gone wrong on the website's server, but the server could not be more specific on what the exact problem is.

502Bad Gateway. The server, which was acting as a gateway or proxy, received an invalid response from the upstream server.

`id` which can be used when calling the quotes/{id} endpoint, to retrieve these quotes.