---
title: "Carrier offers grouped by load, enriched with Vortex load detail"
method: GET
path: "/v3/offers/dashboard"
tags: ["offers"]
---

# Carrier offers grouped by load, enriched with Vortex load detail

`GET /v3/offers/dashboard`

## 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/v3/offers/dashboard`
- Auth: HTTP bearer

## Query parameters

- `period_days` integer, nullable: Trailing window size in days. Offers are filtered by sent_at (skipped by updated_at). Mutually exclusive with start_datetime + end_datetime_exclusive.
- `start_datetime` string, date-time, nullable: Inclusive window start (timezone-aware ISO-8601). Requires end_datetime_exclusive; mutually exclusive with period_days.
- `end_datetime_exclusive` string, date-time, nullable: Exclusive window end (timezone-aware ISO-8601). Requires start_datetime; mutually exclusive with period_days. UI inclusive end dates must be converted to the next-day midnight.

## Headers

- `mentium-workspace-id` string, nullable

## Response `200`

Successful Response

- OffersDashboardResponse
  - `summary` OffersDashboardSummary, required
    - `total_offers_sent` integer, required
    - `loads_with_offers` integer, required
    - `message_offers` integer, required
    - `phone_offers` integer, required
    - `sent` integer, required
    - `negotiating` integer, required
    - `human_hand_off` integer, required
    - `accepted` integer, required
    - `booked` integer, required
    - `declined` integer, required
    - `closed` integer, required
    - `skipped` integer
    - `rate_disputes` integer: Offers where a carrier asked to change an already-agreed rate
  - `loads` LoadOffersGroup[], required
    - `load_offer_id` string, required
    - `external_reference_load_id` string, required
    - `is_active` boolean
    - `customer_name` string, nullable
    - `origin` string, nullable
    - `destination` string, nullable
    - `dispatch_rep` string, nullable
    - `equipment` string, nullable
    - `miles` integer, nullable
    - `pickup_window` string, nullable
    - `delivery_window` string, nullable
    - `customer_rate_amount` number, nullable
    - `min_load_offer_carrier_rate_amount` number, nullable
    - `market_rate_amount` number, nullable
    - `load_board_posted_carrier_rate_amount` number, nullable
    - `total_offer_count` integer
    - `buckets` LoadOffersBuckets: One LoadBucketStats per dashboard status tab.
      - `sent` LoadBucketStats: Aggregates for one status tab within one load group.
        - `count` integer
        - `message_count` integer
        - `phone_count` integer
        - `min_carrier_rate_amount` number, nullable
        - `min_carrier_rate_carrier_name` string, nullable
        - `last_activity_at` string, date-time, nullable
        - `last_activity_status` string, nullable
        - `last_activity_source` string, nullable
      - `negotiating` LoadBucketStats: Aggregates for one status tab within one load group.
        - `count` integer
        - `message_count` integer
        - `phone_count` integer
        - `min_carrier_rate_amount` number, nullable
        - `min_carrier_rate_carrier_name` string, nullable
        - `last_activity_at` string, date-time, nullable
        - `last_activity_status` string, nullable
        - `last_activity_source` string, nullable
      - `human_hand_off` LoadBucketStats: Aggregates for one status tab within one load group.
        - `count` integer
        - `message_count` integer
        - `phone_count` integer
        - `min_carrier_rate_amount` number, nullable
        - `min_carrier_rate_carrier_name` string, nullable
        - `last_activity_at` string, date-time, nullable
        - `last_activity_status` string, nullable
        - `last_activity_source` string, nullable
      - `accepted` LoadBucketStats: Aggregates for one status tab within one load group.
        - `count` integer
        - `message_count` integer
        - `phone_count` integer
        - `min_carrier_rate_amount` number, nullable
        - `min_carrier_rate_carrier_name` string, nullable
        - `last_activity_at` string, date-time, nullable
        - `last_activity_status` string, nullable
        - `last_activity_source` string, nullable
      - `booked` LoadBucketStats: Aggregates for one status tab within one load group.
        - `count` integer
        - `message_count` integer
        - `phone_count` integer
        - `min_carrier_rate_amount` number, nullable
        - `min_carrier_rate_carrier_name` string, nullable
        - `last_activity_at` string, date-time, nullable
        - `last_activity_status` string, nullable
        - `last_activity_source` string, nullable
      - `declined` LoadBucketStats: Aggregates for one status tab within one load group.
        - `count` integer
        - `message_count` integer
        - `phone_count` integer
        - `min_carrier_rate_amount` number, nullable
        - `min_carrier_rate_carrier_name` string, nullable
        - `last_activity_at` string, date-time, nullable
        - `last_activity_status` string, nullable
        - `last_activity_source` string, nullable
      - `closed` LoadBucketStats: Aggregates for one status tab within one load group.
        - `count` integer
        - `message_count` integer
        - `phone_count` integer
        - `min_carrier_rate_amount` number, nullable
        - `min_carrier_rate_carrier_name` string, nullable
        - `last_activity_at` string, date-time, nullable
        - `last_activity_status` string, nullable
        - `last_activity_source` string, nullable
      - `skipped` LoadBucketStats: Aggregates for one status tab within one load group.
        - `count` integer
        - `message_count` integer
        - `phone_count` integer
        - `min_carrier_rate_amount` number, nullable
        - `min_carrier_rate_carrier_name` string, nullable
        - `last_activity_at` string, date-time, nullable
        - `last_activity_status` string, nullable
        - `last_activity_source` string, nullable

## 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)