MCP documentation | MCP docs for agents

ark_get_carrier_history

ark.get_carrier_history

Get FMCSA carrier profile change history for a visible ARK carrier, optionally filtered by category.

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

Input

carrierIdstringrequired

Visible ARK carrier ID whose FMCSA change history should be returned.

format: uuid

categorystring

Optional carrier profile change category.

one of: all, status, identity, contact, safety, fleet, insurance, authority; default: "all"

fieldPrefixstring

Optional raw FMCSA field prefix filter.

min length: 1; max length: 100

cursorstring

Pagination cursor returned by the previous call.

limitinteger

default: 25; min: 1; max: 100

Result

The tool returns the canonical ark.get_carrier_history 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.