> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.ovrsea.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quote requests and shipments

> Ask for a price first, or order the transport directly

The API offers two ways to move goods. Both take the same body: cargo, mode, load type, incoterm, insurance, dates and a route of locations and ports.

| | Quote request | Shipment |
| - | - | - |
| Endpoint | `POST /v1/quote-requests` | `POST /v1/shipments` |
| What you commit to | Nothing: you ask for a price | Moving the goods |
| What OVRSEA does next | Prices the request and sends you offers | Prices and books the transport |
| Returned id | `ovrsea_quote_request_id` | `ovrsea_shipment_id` |

## Quote request

Use it when you need a price before deciding. OVRSEA's team prices the request and sends you one or more offers, each with its price, transit time and validity.

Accepting an offer turns the quote request into a shipment. The shipment keeps the same id: `ovrsea_quote_request_id` becomes its `ovrsea_shipment_id`. A quote request with no accepted offer never becomes a shipment.

The API cannot yet read a quote request, list its offers or accept one. Do it on the OVRSEA platform, where quote requests appear as quotations.

## Shipment

Use it when the transport is decided, for example on rates you already agreed with OVRSEA. The shipment is created awaiting booking, and OVRSEA prices and books it.

## Common rules

* Both endpoints run the same checks on the body, and refuse a location your account cannot see.
* Both count against one creation limit per account. Past it, they answer `429` with a `Retry-After` header.
* A quote request also accepts `urgent`.

The OVRSEA platform and the [MCP server](https://apidoc.ovrsea.com/ai/mcp-server.md) call a quote request a quotation.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.