---
title: "Delivery fee + order quote for a California destination"
method: GET
path: "/delivery-quote"
tags: ["Business"]
---

# Delivery fee + order quote for a California destination

`GET /delivery-quote`

## Request

- Base URL: `https://www.primecutsnursery.com/api/v1`
- URL: `https://www.primecutsnursery.com/api/v1/delivery-quote`
- Auth: none required

The nursery's own delivery calculator: Google driving round trip from Sonoma × $3/mile (<199 round-trip mi) or $2/mile (199+), capped at $1,450. With product + quantity also returns the per-plant tier, subtotal, free-delivery eligibility and total. Fee-only; no scheduling. Cached 1 h.

## Query parameters

- `destination` string
- `pickup` boolean
- `product` 'clones' | 'talls' | 'teens' | 'teens_4in' | 'snips'
- `quantity` integer

## Response `200`

Quote

- object
  - `api_version` string, required
  - `publisher` Publisher, required
    - `name` string, required
    - `url` string, uri, required: Site root
    - `@id` string, uri, required: schema.org Organization @id used across the site's JSON-LD
  - `meta` Meta, required
    - `generated_at` string, date-time, required: When this payload was produced
    - `source` string, required: Where the data came from: 'repo' (curated site content) or 'live-inventory' (the nursery's live stock count, same figures as /live-inventory)
    - `as_of` string, date-time: For live data: when the underlying inventory snapshot was taken
    - `total` integer: Total matches before paging
    - `limit` integer
    - `offset` integer
    - `html_url` string, uri: Canonical HTML page for this resource
    - `notes` string[]: Caveats an agent should surface to a user
    - `interpreted` string[]: Search endpoints: how a free-text q was read (e.g. 'flowering ≤ 8 weeks')
  - `data` DeliveryQuote, required
    - `delivery` object, required
      - `mode` 'delivery' | 'pickup', required
      - `destination` string: Destination as given
      - `origin` string
      - `one_way_miles` number
      - `round_trip_miles` number
      - `round_trip_drive_minutes` integer
      - `cost_per_mile` number: 3 under 199 round-trip miles, else 2
      - `delivery_fee` number: USD before any free-delivery rule
      - `capped_at_max` boolean: true when the $1,450 cap applied
      - `formula` string
      - `pickup_location` string
      - `note` string
    - `order` object, nullable, required
      - `product` 'clones' | 'talls' | 'teens' | 'teens_4in' | 'snips', required
      - `product_name` string, required
      - `quantity` integer, required
      - `minimum_order` integer, required
      - `minimum_per_strain` integer
      - `below_minimum` boolean, required
      - `tier` string, nullable, required: Tier label that applies, e.g. 500+
      - `unit_price_usd` number, nullable, required
      - `subtotal_usd` number, nullable, required
      - `pricing_tiers` object[], required
        - `label` string, required
        - `min` integer, required
        - `price` number, required
      - `free_delivery_from` integer, nullable, required: Quantity at which delivery is free for this product (null = never)
      - `url` string, uri, required: Canonical HTML page for this resource
    - `totals` object, required
      - `delivery_fee_usd` number, required: Fee actually charged (0 when free delivery applies or pickup)
      - `free_delivery_applied` boolean, required
      - `product_subtotal_usd` number
      - `total_usd` number

## Other responses

- `400`: Missing destination, unroutable address, unknown product, or product without quantity
- `503`: Distance calculator unreachable

---

[API](https://skmtc.dev/primecutsnursery/apis/prime-cuts-nursery-public-api.md) · [All operations](https://skmtc.dev/primecutsnursery/apis/prime-cuts-nursery-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/primecutsnursery/apis/prime-cuts-nursery-public-api/revisions/ecf137a90e29?raw)