# Get a quote

`GET /client_api/v2/quotes/{id}`

Read a quote again, with its estimates.

## Parameters

- `id` (integer, required): The quote's id, from Create a quote.

## Returns

Returns the quote.

- `quote` (object, required): The quote.
  - `id` (integer, required): The quote's id.
  - `dirty` (boolean, required): Always `false`. Nothing sets it.
  - `errors` (array of values, required): Why a carrier could not price the shipment, one message per carrier that refused. Empty when every carrier priced it.
  - `estimate_taxes_and_duties` (boolean, required): `true` when the estimates include the destination's duties and taxes.
  - `estimates` (array of objects, required): One estimate per carrier service that could take the shipment. Book one with Create an order.
    - `billable_weights` (object, required): The weights the carrier charges on, in metric and in imperial units.
      - `metric` (object, required): The weights in kilograms, the sizes in centimetres and the volume in cubic metres.
        - `packages` (integer, required): How many packages there are.
        - `mass_unit` (string, required): Always `kg`.
        - `distance_unit` (string, required): Always `cm`.
        - `volumetric_weight` (number, required): The weight the carrier works out from the packages' size.
        - `weight` (number, required): What the packages weigh together.
        - `billable_weight` (number, required): The weight the carrier charges on, the larger of `weight` and `volumetric_weight`.
        - `volume` (number, required): The packages' volume together.
      - `imperial` (object, required): The weights in pounds, the sizes in inches and the volume in cubic feet.
        - `packages` (integer, required): How many packages there are.
        - `mass_unit` (string, required): Always `lb`.
        - `distance_unit` (string, required): Always `inches`. A request spells the same unit `inch`.
        - `volumetric_weight` (number, required): The weight the carrier works out from the packages' size.
        - `weight` (number, required): What the packages weigh together.
        - `billable_weight` (number, required): The weight the carrier charges on, the larger of `weight` and `volumetric_weight`.
        - `volume` (number, required): The packages' volume together.
    - `estimate_id` (integer, required): The estimate's id. Book it by sending it as an order's `quote_estimate_id`.
    - `line_items` (array of objects, required): What the price is made of, one charge per line.
      - `cost` (number, required): What the charge costs, in `currency_id`.
      - `currency_id` (string, required): The currency the company is billed in.
      - `description` (string, required): The charge, such as freight or fuel surcharge.
    - `quote_expired` (boolean, required): `true` when this price no longer holds, because another estimate was booked or the shipment changed. Get a new quote.
    - `shipping_company` (string, required): The carrier.
    - `shipping_service` (string, required): The carrier's service, such as International Priority.
  - `hub_transit` (boolean, required): `true` when the shipment goes through one of our hubs on the way.

## Errors

- `401 Unauthorized`: The token is missing, expired or invalid. Sign in again.

## Example request (curl)

```bash
curl -X GET "https://sandbox-api.vatit-stream.com/client_api/v2/quotes/40" \
  -H "Authorization: Bearer $API_TOKEN"
```

## Example response (200)

```json
{
  "quote": {
    "id": 40,
    "dirty": false,
    "errors": [],
    "estimate_taxes_and_duties": false,
    "estimates": [
      {
        "billable_weights": {
          "metric": {
            "packages": 1,
            "mass_unit": "kg",
            "distance_unit": "cm",
            "volumetric_weight": 16.8,
            "weight": 12.5,
            "billable_weight": 16.8,
            "volume": 0.084
          },
          "imperial": {
            "packages": 1,
            "mass_unit": "lb",
            "distance_unit": "inches",
            "volumetric_weight": 37.04,
            "weight": 27.56,
            "billable_weight": 37.04,
            "volume": 2.9664316254643865
          }
        },
        "estimate_id": 35,
        "line_items": [
          {
            "cost": 2184.5,
            "currency_id": "ZAR",
            "description": "Freight"
          },
          {
            "cost": 393.21,
            "currency_id": "ZAR",
            "description": "Fuel surcharge"
          },
          {
            "cost": 450,
            "currency_id": "ZAR",
            "description": "Customs clearance"
          }
        ],
        "quote_expired": false,
        "shipping_company": "FedEx",
        "shipping_service": "International Priority"
      }
    ],
    "hub_transit": false
  }
}
```