ARK TMS

MCP documentation | MCP docs for agents

ark_get_load_report

ark.get_load_report

Return a permissioned paginated load report with lane, equipment, status, customer, carrier, revenue, expense, and margin fields.

Availability
Expanded preview
Scopes
reports:read
ARK permissions
canViewReportscanViewLoadReport
Team visibility
Required and enforced
Approval policy
none
ARK approval request
Not required
Idempotency
Not required
Read-only
Yes
Destructive
No
External side effect
No
Rate limit
OAuth MCP credential and organization budgets

Input

fromstringrequired

Inclusive report start date in YYYY-MM-DD format.

tostringrequired

Inclusive report end date in YYYY-MM-DD format.

teamIdsarray<string>

Optional visible team IDs. Omit to use all teams available to the connection.

min items: 1; max items: 100

loadStatusarray<string>

default: ["Pending","Dispatched","Delivered"]; max items: 50

customerIdstring

format: uuid

salesRepIdstring

format: uuid

brokerIdstring

format: uuid

carrierIdstring

format: uuid

originCitystring

min length: 1; max length: 100

originStatestring

min length: 1; max length: 50

destinationCitystring

min length: 1; max length: 100

destinationStatestring

min length: 1; max length: 50

loadSizestring

min length: 1; max length: 50

trailerstring

min length: 1; max length: 100

dateFilterTypestring

one of: delivery_date, created_date, booking_date, pickup_date; default: "delivery_date"

customerCurrencystring

one of: USD, CAD, MXN

carrierCurrencystring

one of: USD, CAD, MXN

pageinteger

default: 1; min: 1

pageSizeinteger

default: 50; min: 1; max: 500

sortColumnstring

one of: loadNumber, status, customerCurrency, carrierCurrency, revenue, expenses, margin, customer, carrier, origin, destination; default: "loadNumber"

sortDirectionstring

one of: asc, desc; default: "desc"

Result

The tool returns the canonical ark.get_load_report operation result in structuredContent and mirrors the same JSON as text. Errors set isError: true and return a stable error code, message, and optional details.