Record a manually-booked freight quote

Inserts a freight_quotes row for the order. This is the manual entry path for quotes the operator received outside Shippo (phone calls, carrier portals, brokers). The order must already be flagged as freight; the gate returns 400 order_not_freight otherwise. Carrier and amount are required; currency defaults to USD; quote_number, transit days, expires_at, and notes are optional. The new row is created with accepted_at = null (operator explicitly accepts a quote via POST /freight_quotes//accept). The canonical helper createFreightQuote audits the insert. Idempotent on Idempotency-Key. Requires the orders:write scope.

POST /freight_orders/{id}/quotes

Record a manually-booked freight quote

cURL

curl --request POST \
  --url https://api.arcuserp.com/v1/freight_orders/{id}/quotes \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "carrier_name": "Estes Express",
  "carrier_service": "Standard LTL",
  "quote_number": "EST-2026-77821",
  "transit_days": 4,
  "amount": 642.5,
  "currency": "USD",
  "expires_at": "2026-05-25T17:00:00Z",
  "notes": "Phoned in 2026-05-18 by S. Allen."
}
'

201

{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "entity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "order_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "carrier_name": "<string>",
    "carrier_service": "<string>",
    "quote_number": "<string>",
    "transit_days": 123,
    "amount": 123,
    "currency": "USD",
    "quoted_at": "2023-11-07T05:31:56Z",
    "expires_at": "2023-11-07T05:31:56Z",
    "accepted_at": "2023-11-07T05:31:56Z",
    "accepted_by_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "notes": "<string>",
    "raw_response": {},
    "created_by_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z",
    "metadata": {}
  }
}

Authorizations

Authorization · string · header · required

API key issued per entity via Settings > Developers > API Keys. Each key carries scopes (e.g. orders:read, products:write). Bearer token format: Authorization: Bearer ark_live_ent_ Test keys use ark_test_ent_. Both are issued per entity via Settings > Developers > API Keys.

Headers

Idempotency-Key · string

Client-generated unique key for idempotent POST/PATCH/DELETE operations. Alias for the Idempotency parameter. Max 255 chars. On retry with the same key, the original response is returned without re-executing the operation. Keys expire after 24 hours.

Maximum string length: 255

Path Parameters

id · string<uuid> · required

Body

application/json

carrier_name · string · required

Maximum string length: 100

Example:

"Estes Express"

amount · number<float> · required

Required range: x >= 0

Example:

642.5

carrier_service · string | null

Maximum string length: 60

Example:

"Standard LTL"

quote_number · string | null

Maximum string length: 80

Example:

"EST-2026-77821"

transit_days · integer | null

Required range: x >= 0

Example:

4

currency · string · default: USD

Example:

"USD"

expires_at · string<date-time> | null

Example:

"2026-05-25T17:00:00Z"

notes · string | null

raw_response · object | null

Optional raw carrier payload for the audit trail.

Response

201

application/json

Freight quote created

data · object

A carrier rate-quote attached to a freight order. Created either manually (operator booked a carrier outside Shippo) via POST /freight_orders/{id}/quotes, or in bulk by pulling Shippo LTL rates via POST /freight_orders/{id}/quotes/shippo. Exactly one quote per order may carry a non-null accepted_at; accepting a quote rolls its amount into orders.shipping_total. Rule 23 SSOT: amount is written only by createFreightQuoteHandler and the Shippo rate-import; accepted_at is written only by acceptFreightQuoteHandler. Scope: orders:read / orders:write.

Show child attributes