v2
tms
v2
tms
loads

Post Load To Dat

Post a single load to the DAT Load Board.

Delegates to Vortex's LoadService.PostLoadToDAT gRPC — Vortex owns the load data, DAT credentials, and the load_dat_posting audit row.

post/v2/tms/loads/{external_reference_id}/post-to-dat

Request

  • Base URL
    https://api.mentium.io (the document declares no server; this is the origin it was published from)
  • Auth
    HTTP bearer

Path parameters

external_reference_idstring required

Query parameters

integration_connection_idstring required

TMS integration connection ID (used to fetch the load).

Headers

mentium-workspace-idstring nullable

Request body

dat_integration_connection_idstring required

DAT integration connection ID used to post.

commentsstring nullable

Optional comment posted with the load (max 70 chars).

is_tracking_requiredboolean

Whether DAT tracking should be required.

rate_usdnumber nullable

Rate to advertise on the board, in USD. The caller resolves it — the load view prefills the offer's configured minimum carrier rate. Required unless omit_rate is set.

rate_source'MANUAL_OVERRIDE' | 'OFFER_MIN_RATE' | 'OFFER_MAX_RATE'

Where the rate advertised on a load-board posting came from.

A posting may legally carry no rate, in which case no source is recorded.

contact_method'EMAIL' | 'PRIMARY_PHONE' | 'ALTERNATE_PHONE' nullable

DAT preferred contact method; defaults to email.

contact_emailstring nullable

Contact email on the posting. Omit to let DAT use the posting account's own details.

contact_phonestring nullable

Contact phone on the posting.

omit_rateboolean

Post with no rate at all ('call for rate'), ignoring rate_usd and the load's carrier target.

Response

Successful Response

successboolean required
posting_status'POSTED' | 'ALREADY_POSTED' | 'FAILED' | 'RETRYING' required

Outcome of an attempt to post a load to a load board.

Board-agnostic: DAT is the first board wired up, but nothing here names it.

load_external_reference_idstring required
dat_posting_idstring nullable
dat_responseobject nullable
errorstring nullable
messagestring required
rate_usdnumber nullable

Rate advertised on the board; null means 'call for rate'.

rate_source'MANUAL_OVERRIDE' | 'OFFER_MIN_RATE' | 'OFFER_MAX_RATE'

Where the rate advertised on a load-board posting came from.

A posting may legally carry no rate, in which case no source is recorded.

Changes

No recorded changes to this operation across all 2 revisions of this API.