Owner-scoped carrier, authority and observed-insurance research. All data operations require active Pro. Additional scopes, historical grants, source availability and current suppressions apply. Source observation, effective dates, edition dates and renewal estimates represent distinct facts.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/truckerfetch:truckerfetch-pro-api-v1-api"curl "https://apis.io/api/v1/apis?limit=25"Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
{"openapi":"3.1.1","info":{"title":"TruckerFetch Pro API","version":"1.0.0","description":"Owner-scoped carrier, authority and observed-insurance research. All data operations require active Pro. Additional scopes, historical grants, source availability and current suppressions apply. Source observation, effective dates, edition dates and renewal estimates represent distinct facts."},"servers":[{"url":"https://truckerfetch.com/api/v1"}],"paths":{"/account":{"get":{"operationId":"getAccount","summary":"Get Account","description":"Requires active Pro and an owner-scoped REST bearer key. This REST operation requires no additional field scope.","x-required-scopes":[],"parameters":[],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/usage":{"get":{"operationId":"getUsage","summary":"Get Usage","description":"Requires active Pro and an owner-scoped REST bearer key. This REST operation requires no additional field scope.","x-required-scopes":[],"parameters":[],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/editions/latest":{"get":{"operationId":"getLatestEdition","summary":"Get Latest Edition","description":"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 normal opt-in notifications.","x-required-scopes":[],"parameters":[],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"anyOf":[{"$ref":"#/components/schemas/Edition"},{"type":"null"}]},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}},"examples":{"published":{"summary":"Fictional published edition; dates and counts are illustrative","value":{"data":{"id":"00000000-0000-4000-8000-000000000004","edition_date":"2026-11-04","revision":1,"release_id":"00000000-0000-4000-8000-000000000001","cutoff_at":"2026-11-04T13:00:00Z","published_at":"2026-11-04T13:00:05Z","source_updated_at":"2026-11-03T10:00:00Z","lead_count":1,"private_count":0,"for_hire_count":1,"delivery_status":"published","last_decision_date":"2026-11-04"},"meta":{"request_id":"00000000-0000-4000-8000-000000000005"}}},"beforeFirstPublication":{"summary":"No published edition yet","value":{"data":null,"meta":{"request_id":"00000000-0000-4000-8000-000000000005"}}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/editions":{"get":{"operationId":"listEditions","summary":"List Editions","description":"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 editions and queue normal opt-in notifications.","x-required-scopes":["data:read"],"parameters":[{"in":"query","name":"cursor","schema":{"type":"string","maxLength":1800}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Edition"}},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/editions/{id}":{"get":{"operationId":"getEdition","summary":"Get Edition","description":"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.","x-required-scopes":["data:read"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Edition"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/carriers/{dot}":{"get":{"operationId":"getCarrier","summary":"Get Carrier","description":"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 establish a negative fact.","x-required-scopes":["data:read"],"parameters":[{"in":"path","name":"dot","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[0-9]{1,16}$","description":"A nonzero USDOT identifier as a string; leading zeroes are normalized by the service."}},{"in":"query","name":"edition_id","schema":{"type":"string","format":"uuid"},"description":"Pin the profile to an included or already-unlocked edition that remains within the historical access window."}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{"$ref":"#/components/schemas/Carrier"},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/carriers/{dot}/authorities":{"get":{"operationId":"listAuthorities","summary":"List Authorities","description":"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.","x-required-scopes":["data:read"],"parameters":[{"in":"path","name":"dot","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[0-9]{1,16}$","description":"A nonzero USDOT identifier as a string; leading zeroes are normalized by the service."}},{"in":"query","name":"cursor","schema":{"type":"string","maxLength":1800}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/carriers/{dot}/insurance-filings":{"get":{"operationId":"listInsuranceFilings","summary":"List Insurance Filings","description":"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 edition_id.","x-required-scopes":["data:read","insurance:read"],"parameters":[{"in":"path","name":"dot","required":true,"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[0-9]{1,16}$","description":"A nonzero USDOT identifier as a string; leading zeroes are normalized by the service."}},{"in":"query","name":"cursor","schema":{"type":"string","maxLength":1800}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/changes":{"get":{"operationId":"listChanges","summary":"List Changes","description":"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; store events and deduplicate IDs before advancing the resume cursor.","x-required-scopes":["data:read"],"parameters":[{"in":"query","name":"cursor","schema":{"type":"string","maxLength":1800}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"in":"query","name":"usdot","schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[0-9]{1,16}$","description":"A nonzero USDOT identifier as a string; leading zeroes are normalized by the service."}},{"in":"query","name":"since","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"event_types","schema":{"type":"string","maxLength":300},"description":"Comma-separated published event types."},{"in":"query","name":"watchlist_id","schema":{"type":"string","format":"uuid"}}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/watchlists":{"get":{"operationId":"listWatchlists","summary":"List Watchlists","description":"Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:read.","x-required-scopes":["watchlists:read"],"parameters":[],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}},"post":{"operationId":"createWatchlist","summary":"Create Watchlist","description":"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.","x-required-scopes":["watchlists:write"],"parameters":[{"in":"header","name":"Idempotency-Key","required":true,"description":"Persist this key with the exact request payload and reuse both after a timeout or confirmation; a changed payload conflicts.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[-._:a-zA-Z0-9]{8,128}$"}}],"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120},"scope":{"type":"string","enum":["edition","catalog","daily"]},"filters":{"type":"object","properties":{"q":{"type":"string","maxLength":160},"states":{"maxItems":51,"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"classifications":{"maxItems":64,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"entity_types":{"maxItems":64,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"cargo":{"maxItems":64,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"niches":{"maxItems":14,"type":"array","items":{"type":"string","enum":["trucking","towing","auto_transport","hvac","plumbing","electrical","construction","landscaping","moving","waste","fuel_chemicals","agriculture","passenger","pest_control"]}},"months_in_business":{"type":"object","properties":{"min":{"type":"integer","minimum":0,"maximum":1200},"max":{"type":"integer","minimum":0,"maximum":1200}},"additionalProperties":false},"filing_types":{"maxItems":64,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"insurer":{"type":"string","minLength":1,"maxLength":160},"census_status":{"maxItems":64,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"operations":{"maxItems":64,"type":"array","items":{"type":"string","minLength":1,"maxLength":100}},"fleet":{"type":"object","properties":{"min":{"type":"integer","minimum":0,"maximum":9007199254740991},"max":{"type":"integer","minimum":0,"maximum":9007199254740991}},"additionalProperties":false},"trucks":{"type":"object","properties":{"min":{"type":"integer","minimum":0,"maximum":9007199254740991},"max":{"type":"integer","minimum":0,"maximum":9007199254740991}},"additionalProperties":false},"drivers":{"type":"object","properties":{"min":{"type":"integer","minimum":0,"maximum":9007199254740991},"max":{"type":"integer","minimum":0,"maximum":9007199254740991}},"additionalProperties":false}},"additionalProperties":false}},"required":["name"],"additionalProperties":false}}}},"responses":{"201":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/watchlists/{id}":{"get":{"operationId":"getWatchlist","summary":"Get Watchlist","description":"Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:read.","x-required-scopes":["watchlists:read"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}},"patch":{"operationId":"renameWatchlist","summary":"Rename Watchlist","description":"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.","x-required-scopes":["watchlists:write"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}}],"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":120}},"required":["name"],"additionalProperties":false}}}},"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}},"delete":{"operationId":"deleteWatchlist","summary":"Delete Watchlist","description":"Requires active Pro and an owner-scoped REST bearer key. Required scopes: watchlists:write.","x-required-scopes":["watchlists:write"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/watchlists/{id}/targets":{"get":{"operationId":"listAuthorityWatchTargets","summary":"List Authority Watch Targets","description":"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.","x-required-scopes":["watchlists:read"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"query","name":"cursor","schema":{"type":"string","format":"uuid"}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}},"post":{"operationId":"followAuthority","summary":"Follow Authority","description":"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. Save the payload and Idempotency-Key.","x-required-scopes":["watchlists:write"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"header","name":"Idempotency-Key","required":true,"description":"Persist this key with the exact request payload and reuse both after a timeout or confirmation; a changed payload conflicts.","schema":{"type":"string","minLength":8,"maxLength":128,"pattern":"^[-._:a-zA-Z0-9]{8,128}$"}}],"security":[{"apiKey":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"usdot":{"type":"string","pattern":"^[0-9]{1,16}$"},"docket_number":{"type":"string","minLength":1,"maxLength":64},"authority_type":{"type":"string","minLength":1,"maxLength":160},"authority_record_id":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"}},"required":["usdot","docket_number","authority_type","authority_record_id"],"additionalProperties":false}}}},"responses":{"201":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/watchlists/{id}/events":{"get":{"operationId":"listMatchingWatchEvents","summary":"List Matching Watch Events","description":"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 events before advancing the resume cursor.","x-required-scopes":["watchlists:read"],"parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string","format":"uuid"}},{"in":"query","name":"cursor","schema":{"type":"string","maxLength":1800}},{"in":"query","name":"limit","schema":{"type":"integer","minimum":1,"maximum":100,"default":50}},{"in":"query","name":"usdot","schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"string","pattern":"^[0-9]{1,16}$","description":"A nonzero USDOT identifier as a string; leading zeroes are normalized by the service."}},{"in":"query","name":"since","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"event_types","schema":{"type":"string","maxLength":300},"description":"Comma-separated published event types."}],"security":[{"apiKey":[]}],"responses":{"200":{"description":"Authorized operation result","headers":{"X-Request-Id":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","meta"],"properties":{"data":{},"meta":{"$ref":"#/components/schemas/ResponseMeta"},"next_cursor":{"type":"string"}}}}}},"400":{"description":"Invalid request"},"401":{"description":"Credential required"},"402":{"description":"Active Pro required"},"403":{"description":"Insufficient scope or allowance"},"404":{"description":"Unknown or inaccessible resource"},"409":{"description":"Idempotency conflict, changed projection or owner confirmation required"},"410":{"description":"Expired cursor, artifact or dated edition outside the rolling 90-day Lead History window (archive_expired); the latest published edition remains available"},"429":{"description":"Request limit exceeded","headers":{"Retry-After":{"schema":{"type":"string"}}}},"503":{"description":"Service or binding unavailable"}}}},"/evidence/{id}":{"get":{"operationId":"getEvidence","summary":"Get Evidence","description":"Requires active Pro and an owner-scoped REST bearer key. R
# --- truncated at 32 KB (78 KB total) ---
# Full source: https://artifacts.apis.io/truckerfetch/openapi/_original/truckerfetch-v1-openapi.json