---
title: "Get offer or calculated defaults (no auto-create)"
method: GET
path: "/v2/tms/offers/by-load/{external_reference_load_id}"
tags: ["v2", "tms", "Load Offers"]
---

# Get offer or calculated defaults (no auto-create)

`GET /v2/tms/offers/by-load/{external_reference_load_id}`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v2/tms/offers/by-load/{external_reference_load_id}`
- Auth: HTTP bearer

Returns existing offer or calculated defaults WITHOUT auto-creating.

    Use this endpoint to display offer values without persisting them until
    the user explicitly saves. This allows TMS changes (like Beginning Buy Rate
    updates) to be reflected until user saves.

    **Response includes `is_saved` flag:**
    - `is_saved=true`: Offer exists in DB, showing saved values
    - `is_saved=false`: No offer exists, showing calculated defaults from TMS

## Path parameters

- `external_reference_load_id` string, required

## Query parameters

- `integration_connection_id` string, required: TMS integration connection UUID

## Headers

- `mentium-workspace-id` string, nullable

## Response `200`

Successful Response

- OfferOrDefaultResponse: Response from get_or_default endpoint - includes is_saved flag
  - `id` string, nullable
  - `organization_id` string, required
  - `workspace_id` string, required
  - `integration_connection_id` string, required
  - `external_reference_load_id` string, required
  - `customer_rate_amount` number, nullable
  - `min_load_offer_carrier_rate_amount` number, nullable, required
  - `min_load_offer_carrier_rate_source` string, nullable
  - `max_load_offer_carrier_rate_amount` number, nullable
  - `max_load_offer_carrier_rate_source` string, nullable
  - `load_board_posted_carrier_rate_amount` number, nullable: What the TMS has the load posted at on the load boards; no quote is below it (ENG-2550).
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `is_saved` boolean, required: True if offer exists in DB, False if showing calculated defaults
  - `carrier_offers` CarrierOfferSchema[]: Carrier offers for this load (only populated when is_saved=True)
    - `id` string, required
    - `load_offer_id` string, required
    - `conversation_id` string, nullable
    - `external_reference_carrier_id` string, required
    - `carrier_email` string, nullable
    - `carrier_name` string, nullable
    - `status` 'QUEUED' | 'SENT' | 'NEGOTIATING' | 'HUMAN_HAND_OFF' | 'BOOKED' | 'ACCEPTED' | 'DECLINED' | 'CLOSED' | 'CANCELLED' | 'SKIPPED', required
    - `skip_reason` string, nullable
    - `min_carrier_offer_carrier_rate_amount` string, nullable
    - `min_carrier_offer_carrier_rate_source` 'RELATIVE_TO_TMS_MIN_CARRIER_RATE' | 'RELATIVE_TO_TMS_MAX_CARRIER_RATE' | 'RELATIVE_TO_TMS_CUSTOMER_RATE' | 'RELATIVE_TO_DAT_MARKET_RATE' | 'RELATIVE_TO_GREENSCREENS_MARKET_RATE' | 'RELATIVE_TO_MIN_LOAD_OFFER_CARRIER_RATE' | 'RELATIVE_TO_MAX_LOAD_OFFER_CARRIER_RATE' | 'RELATIVE_TO_HISTORICAL_CARRIER_RATE' | 'RELATIVE_TO_LOAD_BOARD_POSTED_CARRIER_RATE' | 'MANUAL_OVERRIDE' | 'MENTIUM_UNKNOWN_VALUE'
    - `min_carrier_offer_carrier_rate_source_raw_amount` string, nullable
    - `max_carrier_offer_carrier_rate_amount` string, nullable
    - `max_carrier_offer_carrier_rate_source` 'RELATIVE_TO_TMS_MIN_CARRIER_RATE' | 'RELATIVE_TO_TMS_MAX_CARRIER_RATE' | 'RELATIVE_TO_TMS_CUSTOMER_RATE' | 'RELATIVE_TO_DAT_MARKET_RATE' | 'RELATIVE_TO_GREENSCREENS_MARKET_RATE' | 'RELATIVE_TO_MIN_LOAD_OFFER_CARRIER_RATE' | 'RELATIVE_TO_MAX_LOAD_OFFER_CARRIER_RATE' | 'RELATIVE_TO_HISTORICAL_CARRIER_RATE' | 'RELATIVE_TO_LOAD_BOARD_POSTED_CARRIER_RATE' | 'MANUAL_OVERRIDE' | 'MENTIUM_UNKNOWN_VALUE'
    - `max_carrier_offer_carrier_rate_source_raw_amount` string, nullable
    - `opening_carrier_rate_amount` number, nullable
    - `sent_at` string, date-time, nullable
    - `booked_at` string, date-time, nullable
    - `accepted_at` string, date-time, nullable
    - `declined_at` string, date-time, nullable
    - `closed_at` string, date-time, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `latest_carrier_rate_amount` number, nullable
    - `current_carrier_rate_amount` number, nullable
    - `phone_calls` PhoneCallEmbedded[]
      - `id` string, required
      - `direction` string, required
      - `status` string, required
      - `from_number` string, required
      - `to_number` string, required
      - `started_at` string, date-time, nullable
      - `ended_at` string, date-time, nullable
  - `customer_currency` string, nullable: Customer billing currency from Vortex.
  - `org_currency` string, nullable: Currency amounts are stored in Nexus
  - `negotiation_currency_basis` string, nullable: Negotiation currency basis setting (organization|customer|carrier).
  - `display_currency` string, nullable: Currency amounts are displayed in (org's current base currency)
  - `was_converted` boolean: True if amounts were converted from org_currency to display_currency

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)