# TruckerFetch

> Integrate published U.S. carrier, authority and insurance research through the TruckerFetch API, MCP and agent skills.

- [TruckerFetch developer documentation](https://truckerfetch.mintlify.dev/docs/index.md): Connect your systems and assistants to published U.S. motor carrier data, operating authorities, insurance evidence, exports and watch events.
- [Make your first TruckerFetch API call](https://truckerfetch.mintlify.dev/docs/quickstart.md): Create a scoped Pro API key, verify your account access and search a small carrier page while preserving source dates and pagination metadata.
- [Authenticate REST and MCP requests](https://truckerfetch.mintlify.dev/docs/authentication.md): Use scoped API keys for REST and OAuth for hosted MCP, manage credentials in the dashboard and keep secrets outside URLs, prompts and logs.
- [Grant the permissions your integration needs](https://truckerfetch.mintlify.dev/docs/scopes.md): Choose independent data, contact, insurance, watchlist, export, archive and webhook scopes for each TruckerFetch credential or assistant grant.
- [Interpret carrier data and source evidence](https://truckerfetch.mintlify.dev/docs/data-quality.md): Keep Census status, authority status, insurance observations, date bases and source freshness distinct when reporting TruckerFetch carrier research.
- [Search published carriers and paginate results](https://truckerfetch.mintlify.dev/docs/guides/carrier-search.md): Search by state, reported classifications, fleet or text filters, then follow opaque cursors with unchanged selection inputs and source metadata.
- [Read the latest and historical carrier editions](https://truckerfetch.mintlify.dev/docs/guides/editions.md): Find published edition dates, search the included latest edition and open an eligible historical date through explicit owner review and safe retries.
- [Research insurance timing with an explicit date basis](https://truckerfetch.mintlify.dev/docs/guides/renewals.md): Search insurance evidence over a supported timing window and retain the date basis so filing anniversaries are never presented as verified expirations.
- [Create and retrieve a pinned CSV export](https://truckerfetch.mintlify.dev/docs/guides/exports.md): Request an owner-scoped carrier export with a durable idempotency key, monitor the job and download authenticated file parts with integrity metadata.
- [Follow carriers and exact operating authorities](https://truckerfetch.mintlify.dev/docs/guides/watchlists.md): Create an owned watchlist, add published USDOT records or a resolved authority target and read matched events under current account permissions.
- [Receive and verify signed TruckerFetch webhooks](https://truckerfetch.mintlify.dev/docs/guides/webhooks.md): Register your HTTPS destination in the dashboard, verify the exact signed event bytes and deduplicate notifications before retrieving authorized details.
- [Handle shared rate limits and pagination](https://truckerfetch.mintlify.dev/docs/rate-limits.md): Coordinate REST keys and MCP grants within account-wide request and concurrency limits, honor Retry-After and keep retries tied to saved operations.
- [Recover from API errors and owner confirmations](https://truckerfetch.mintlify.dev/docs/errors.md): Interpret stable status codes, keep request IDs for support and recover ambiguous mutations with the original idempotency key and unchanged payload.
- [Get Account](https://truckerfetch.mintlify.dev/docs/api-reference/get-account.md): Requires active Pro and an owner-scoped REST bearer key. This REST operation requires no additional field scope.
- [Get Usage](https://truckerfetch.mintlify.dev/docs/api-reference/get-usage.md): Requires active Pro and an owner-scoped REST bearer key. This REST operation requires no additional field scope.
- [Get Latest Edition](https://truckerfetch.mintlify.dev/docs/api-reference/get-latest-edition.md): Requires active Pro and an owner-scoped REST bearer key. This REST operation requires no additional field scope. Returns the latest published edition with its original source date, which can be older during a source delay. May publish already-due daily editions using the server clock and queue norma…
- [List Editions](https://truckerfetch.mintlify.dev/docs/api-reference/list-editions.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read. Lists published metadata in the rolling 90 Eastern calendar dates, plus the latest published edition during a source delay. Listing metadata does not spend a historical-date allowance. May publish already-due daily…
- [Get Edition](https://truckerfetch.mintlify.dev/docs/api-reference/get-edition.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read. Returns published edition metadata; row-level historical reads separately require the date to be included or already unlocked and still available.
- [Get Carrier](https://truckerfetch.mintlify.dev/docs/api-reference/get-carrier.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read. Returns the permitted current profile, or a profile pinned to an authorized edition_id. Contact fields are returned only with contacts:read. Missing fields, unknown source values and scope-withheld values do not est…
- [List Authorities](https://truckerfetch.mintlify.dev/docs/api-reference/list-authorities.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read. Lists current published authority records for this carrier. Census registration is distinct from operating authority. Historical family projections are unavailable; do not send edition_id.
- [List Insurance Filings](https://truckerfetch.mintlify.dev/docs/api-reference/list-insurance-filings.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read, insurance:read. Lists current observed insurance filings and supported dates. A filing anniversary or estimated renewal is not a verified expiration. Historical family projections are unavailable; do not send editio…
- [List Changes](https://truckerfetch.mintlify.dev/docs/api-reference/list-changes.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read. Returns published changes. A watchlist_id filter additionally requires watchlists:read. Insurance events are visible only with insurance:read and insurance availability. Preserve selection filters with cursors; stor…
- [List Watchlists](https://truckerfetch.mintlify.dev/docs/api-reference/list-watchlists.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:read.
- [Create Watchlist](https://truckerfetch.mintlify.dev/docs/api-reference/create-watchlist.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:write. Creates an owned named watchlist. Optional scope and filters configure its settings. The name is trimmed and must contain 1 to 120 characters. Save the payload and Idempotency-Key before submission.
- [Get Watchlist](https://truckerfetch.mintlify.dev/docs/api-reference/get-watchlist.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:read.
- [Delete Watchlist](https://truckerfetch.mintlify.dev/docs/api-reference/delete-watchlist.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:write.
- [Rename Watchlist](https://truckerfetch.mintlify.dev/docs/api-reference/rename-watchlist.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:write. Renames an owned watchlist. The name is trimmed and must contain 1 to 120 characters.
- [List Authority Watch Targets](https://truckerfetch.mintlify.dev/docs/api-reference/list-authority-watch-targets.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:read. Lists resolved authority targets in this owned watchlist. Use the returned next_cursor target ID for the next page.
- [Follow Authority](https://truckerfetch.mintlify.dev/docs/api-reference/follow-authority.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:write. Follows the exact published usdot, docket_number, authority_type and authority_record_id in an owned watchlist. Resolve these from authority evidence and confirm the target with the user before changing it. S…
- [List Matching Watch Events](https://truckerfetch.mintlify.dev/docs/api-reference/list-matching-watch-events.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:read. Returns published changes matching this owned watchlist. Optional usdot, since and event_types further restrict the feed. Insurance events are visible only with insurance:read and insurance availability. Store…
- [Get Evidence](https://truckerfetch.mintlify.dev/docs/api-reference/get-evidence.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read. Returns a redacted source reference for an authorized fact. Insurance-source evidence additionally requires insurance:read and insurance availability. The parent resource and any historical grant are reauthorized.
- [List Exports](https://truckerfetch.mintlify.dev/docs/api-reference/list-exports.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: exports:read.
- [Request Export](https://truckerfetch.mintlify.dev/docs/api-reference/request-export.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: exports:write, contacts:read. Creates an owner-scoped CSV job pinned to an authorized selection and published release. Save the payload and Idempotency-Key before submission. REST uses the user's explicit selection authorizati…
- [Get Export](https://truckerfetch.mintlify.dev/docs/api-reference/get-export.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: exports:read. Returns the owner's job state. Renewal jobs additionally require insurance:read and insurance availability; edition selections require current historical access. Poll this job rather than enqueueing another expor…
- [Get Export Manifest](https://truckerfetch.mintlify.dev/docs/api-reference/get-export-manifest.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: exports:read, contacts:read. Returns the authenticated manifest with part index, byte length, volume and SHA-256. Renewal jobs additionally require insurance:read and insurance availability; edition selections require current…
- [Get Export Part](https://truckerfetch.mintlify.dev/docs/api-reference/get-export-part.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: exports:read, contacts:read. Downloads an authenticated CSV byte part, at most 2 MiB. Verify its length and SHA-256 against the manifest and assemble parts by volume. Renewal jobs additionally require insurance:read and insura…
- [Get Webhook Endpoints](https://truckerfetch.mintlify.dev/docs/api-reference/get-webhook-endpoints.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: webhooks:read.
- [Get Webhook Deliveries](https://truckerfetch.mintlify.dev/docs/api-reference/get-webhook-deliveries.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: webhooks:read.
- [Search Carriers](https://truckerfetch.mintlify.dev/docs/api-reference/search-carriers.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read. Searches the published catalog. Contact fields require contacts:read. Preserve the original filters and opaque cursor when paginating; data-search cursors retain their initial one-hour deadline.
- [Search Edition](https://truckerfetch.mintlify.dev/docs/api-reference/search-edition.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read. Searches membership in the latest or an already-unlocked edition still within Lead History. Contact fields require contacts:read. Expired historical dates cannot be reopened; preserve filters and the opaque cursor w…
- [Search Renewals](https://truckerfetch.mintlify.dev/docs/api-reference/search-renewals.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: insurance:read. Searches published insurance research. Choose an explicit date_basis to distinguish anniversaries, estimates, verified expirations and filed cancellations. REST defaults to filing_anniversary and 30 days when o…
- [Unlock Historical Edition](https://truckerfetch.mintlify.dev/docs/api-reference/unlock-historical-edition.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: data:read, archive:unlock. Requires account-owner approval in both REST and hosted MCP. Submit the exact edition date with a saved Idempotency-Key; on confirmation_required, give the owner the returned confirmation_url and ret…
- [Add Watch Targets](https://truckerfetch.mintlify.dev/docs/api-reference/add-watch-targets.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:write. Adds one to 100 visible USDOT string identifiers to this owned watchlist. The REST route does not require an Idempotency-Key for this operation.
- [Remove Watch Target](https://truckerfetch.mintlify.dev/docs/api-reference/remove-watch-target.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:write.
- [Unfollow Authority](https://truckerfetch.mintlify.dev/docs/api-reference/unfollow-authority.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:write. Removes the exact resolved authority target from this owned watchlist. Deletion is idempotent; confirm the target with the user before changing it.
- [Update Watch Rules](https://truckerfetch.mintlify.dev/docs/api-reference/update-watch-rules.md): Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:write. Changes future event matching or pauses/resumes this owned watchlist. At least one field is required. Insurance event types additionally require insurance:read and insurance availability.
- [Carriernotification](https://truckerfetch.mintlify.dev/docs/api-reference/carriernotification.md): Verify the exact event bytes with the endpoint signing secret, timestamp and event ID. Use the API to retrieve private details.
- [Connect an assistant through hosted MCP](https://truckerfetch.mintlify.dev/docs/integrations/mcp.md): Authorize the TruckerFetch Streamable HTTP MCP endpoint with OAuth, start with scoped research tools and preserve owner review for consequential actions.
- [Install the TruckerFetch agent skill](https://truckerfetch.mintlify.dev/docs/integrations/agent-skills.md): Add the official carrier research skill to your agent, configure REST or MCP access and preserve evidence, source dates, permissions and owner approvals.
- [Use the official API integration examples](https://truckerfetch.mintlify.dev/docs/integrations/examples.md): Start from small Python and JavaScript examples, configure scoped credentials outside source control and choose hosted MCP or a local bridge for agents.

## OpenAPI Specs

- [openapi](/docs/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.