{"openapi":"3.1.0","info":{"title":"VerifyCarrier API","version":"1.0.0","summary":"US motor-carrier identity, authority, safety, insurance and UCC evidence from public records.","description":"Carrier records come from FMCSA public data, state UCC records and limited reviewed company-website information. Every source keeps its own dates and availability; a source that could not be read is `unavailable`, never a clean record. Nothing here is a carrier approval or a prediction of fraud.\n\n**Allowances.** Basic lookups and name search allow anonymous calls, 10 per IP per UTC day. A free API key includes 100 calls a month; Carrier watch ($49/month) includes 1,000. A used-up allowance returns **402** with error `quota_exhausted` and the next action (`offer`); 429 is not used for allowances.\n\nGuides: https://verifycarrier.com/docs. Keys: https://verifycarrier.com/dashboard/api-keys.","contact":{"name":"VerifyCarrier support","email":"support@verifycarrier.com","url":"https://verifycarrier.com/docs"},"termsOfService":"https://verifycarrier.com/terms"},"externalDocs":{"description":"API guide with examples","url":"https://verifycarrier.com/docs"},"servers":[{"url":"https://verifycarrier.com"}],"tags":[{"name":"Lookup","description":"Basic carrier lookup by USDOT, MC or name. Anonymous access allowed with a daily limit."},{"name":"Evidence","description":"Combined carrier evidence and contact checks."},{"name":"Changes","description":"FMCSA change lists. Paid plan."},{"name":"Directory","description":"Public curated carrier directory snapshot."},{"name":"Fuel","description":"Diesel benchmarks and published fuel surcharge schedules. Paid plan or trial."}],"paths":{"/api/lookup/dot/{dotNumber}":{"get":{"tags":["Lookup"],"operationId":"lookupByDot","summary":"Look up a carrier by USDOT number","description":"Also accepts an MC number written as `MC123456`. Live FMCSA QCMobile data with risk tier, recent-change flags, enrichment and identity signals.","security":[{},{"bearerAuth":[]}],"parameters":[{"name":"dotNumber","in":"path","required":true,"description":"USDOT number (1-8 digits), or MC number prefixed with MC.","schema":{"type":"string","pattern":"^(?:[Mm][Cc])?\\d{1,8}$"},"example":"198"}],"responses":{"200":{"description":"Carrier found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierLookup"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/QuotaExhausted"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/api/lookup/mc/{mcNumber}":{"get":{"tags":["Lookup"],"operationId":"lookupByMc","summary":"Look up a carrier by MC (docket) number","description":"Resolves the MC number to its USDOT carrier. Use the returned `dot_number` for the evidence endpoint.","security":[{},{"bearerAuth":[]}],"parameters":[{"name":"mcNumber","in":"path","required":true,"description":"MC number, 1-8 digits, with or without the MC prefix.","schema":{"type":"string","pattern":"^(?:[Mm][Cc])?\\d{1,8}$"},"example":"147039"}],"responses":{"200":{"description":"Carrier found.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/CarrierLookup"},{"type":"object","properties":{"lookup_type":{"const":"mc_number"}}}]}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/QuotaExhausted"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/api/lookup/{dot}":{"get":{"tags":["Lookup"],"operationId":"lookupAlias","summary":"Alias of /api/lookup/dot/{dotNumber}","security":[{},{"bearerAuth":[]}],"parameters":[{"name":"dot","in":"path","required":true,"description":"USDOT number.","schema":{"type":"string","pattern":"^(?:[Mm][Cc])?\\d{1,8}$"},"example":"198"}],"responses":{"200":{"description":"Carrier found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierLookup"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/QuotaExhausted"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/api/carrier/{dot}":{"get":{"tags":["Lookup"],"operationId":"carrierAlias","summary":"Alias of /api/lookup/dot/{dotNumber}","description":"Basic DOT lookup, not the evidence endpoint.","security":[{},{"bearerAuth":[]}],"parameters":[{"name":"dot","in":"path","required":true,"description":"USDOT number.","schema":{"type":"string","pattern":"^(?:[Mm][Cc])?\\d{1,8}$"},"example":"198"}],"responses":{"200":{"description":"Carrier found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierLookup"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/QuotaExhausted"},"404":{"$ref":"#/components/responses/NotFound"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/api/search":{"get":{"tags":["Lookup"],"operationId":"searchByName","summary":"Search carriers by name","description":"Ranked by match quality (exact legal name, exact DBA, starts-with, all words), then operating status, then power units. Empty results are not proof a company has no records.","security":[{},{"bearerAuth":[]}],"parameters":[{"name":"q","in":"query","required":true,"description":"Carrier name, at least three characters.","schema":{"type":"string","minLength":3},"example":"trucking"},{"name":"limit","in":"query","required":false,"description":"Results to return.","schema":{"type":"integer","minimum":1,"maximum":50,"default":10}}],"responses":{"200":{"description":"Ranked matches.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResults"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/QuotaExhausted"},"500":{"$ref":"#/components/responses/ServerError"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/api/carrier/{dot}/evidence":{"get":{"tags":["Evidence"],"operationId":"carrierEvidence","summary":"Combined carrier evidence","description":"Carrier, insurance, UCC, company-profile, directory and public-review evidence for one USDOT number. Each section reports its own status. Page through UCC filings with `ucc_offset` and `ucc_batch`; a changed batch returns 409. UCC filing details may be withheld on some accounts (`ucc.status = gated`).","security":[{"bearerAuth":[]}],"parameters":[{"name":"dot","in":"path","required":true,"description":"USDOT number, no leading zero.","schema":{"type":"string","pattern":"^[1-9]\\d{0,7}$"},"example":"594"},{"name":"ucc_offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":1000000,"default":0}},{"name":"insurance_offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"maximum":1000000,"default":0}},{"name":"ucc_batch","in":"query","required":false,"description":"Batch id from the first page; pagination restarts if it changed.","schema":{"type":"string"}}],"responses":{"200":{"description":"Evidence, possibly partial.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierEvidence"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Invalid carrier or offset (`invalid_carrier_or_offset`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/QuotaExhausted"},"409":{"description":"UCC batch changed (`ucc_batch_changed`); restart at offset 0 with `batch_id`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/api/carrier/{dot}/contact-check":{"post":{"tags":["Evidence"],"operationId":"contactCheck","summary":"Check a phone or email against FMCSA registration","description":"Does the phone or email on a rate confirmation match the FMCSA-registered contact for this USDOT number, and which other USDOT numbers share it? Submitted values are not stored, logged or echoed. Phone line type is not checked. Metered like a lookup.","security":[{},{"bearerAuth":[]}],"parameters":[{"name":"dot","in":"path","required":true,"schema":{"type":"string","pattern":"^[1-9]\\d{0,7}$"},"example":"198"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"phone":{"type":"string"},"email":{"type":"string","format":"email"}},"minProperties":1}}}},"responses":{"200":{"description":"Comparison result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactCheck"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"`invalid_dot`, `invalid_json` or `phone_or_email_required`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/QuotaExhausted"},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/api/changes/{kind}":{"get":{"tags":["Changes"],"operationId":"changeList","summary":"FMCSA change list","description":"Records behind each change count for the latest source day or week. Included with Carrier watch. Counts against the monthly API allowance.","security":[{"bearerAuth":[]}],"parameters":[{"name":"kind","in":"path","required":true,"schema":{"type":"string","enum":["authorities","authority-removed","suspensions","insurance-cancellations","new-registrations"]}},{"name":"window","in":"query","required":false,"description":"Any value other than `week` is treated as `day`.","schema":{"type":"string","enum":["day","week"],"default":"day"}}],"responses":{"200":{"description":"Change records.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChangeList"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"402":{"$ref":"#/components/responses/QuotaExhausted"},"403":{"description":"Paid plan required (`plan_required`).","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Unknown kind (`unknown_kind`).","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/Error"},{"type":"object","properties":{"kinds":{"type":"array","items":{"type":"string"}}}}]}}}},"503":{"$ref":"#/components/responses/Unavailable"}}}},"/api/carriers/directory":{"get":{"tags":["Directory"],"operationId":"carrierDirectory","summary":"Public carrier directory snapshot","description":"A curated snapshot of about 500 carriers with registered addresses, fleet details and dated website observations. Not the complete US carrier population. No authentication.","security":[{}],"responses":{"200":{"description":"Directory snapshot.","content":{"application/json":{"schema":{"type":"object","required":["interpretation"],"properties":{"interpretation":{"type":"string"}},"additionalProperties":true}}}}}}},"/api/fuel-surcharges":{"get":{"tags":["Fuel"],"operationId":"fuelSurcharges","summary":"Diesel benchmarks and published fuel surcharges","description":"US EIA retail diesel (national and regional), LTL fuel surcharge schedules and parcel surcharges. API key only; browser sessions do not authenticate this endpoint. Not full tariffs or negotiated rates.","security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Fuel data.","content":{"application/json":{"schema":{"type":"object","properties":{"diesel":{},"regionalDiesel":{},"surcharges":{},"parcelSurcharges":{}},"additionalProperties":true}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"}}},"401":{"description":"Missing, invalid or revoked API key.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"402":{"$ref":"#/components/responses/QuotaExhausted"},"403":{"description":"An active paid plan or free trial is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}},"503":{"description":"Fuel data or account verification unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","description":"API key from https://verifycarrier.com/dashboard/api-keys, sent as `Authorization: Bearer <key>`."}},"headers":{"X-RateLimit-Limit":{"description":"Allowance for the current window (anonymous: per UTC day; keyed: per month).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Calls left in the window.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Window end, Unix seconds.","schema":{"type":"integer"}}},"responses":{"BadRequest":{"description":"Invalid input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"No carrier found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Invalid API key (`unauthorized`), or authentication required on a keyed endpoint.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"QuotaExhausted":{"description":"Allowance used up. Anonymous callers are offered a free key; keyed callers the paid plan, or support when no plan raises the limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QuotaExhausted"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"Unavailable":{"description":"Quota checks or a source are temporarily unavailable (`rate_limit_unavailable`, `unavailable`). Retry later.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"headers":{"Retry-After":{"description":"Seconds to wait, when known.","schema":{"type":"integer"}}}},"ServerError":{"description":"Unexpected error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"message":{"type":"string"}},"additionalProperties":true},"Message":{"type":"object","required":["message"],"properties":{"message":{"type":"string"}},"additionalProperties":true},"QuotaOffer":{"type":["object","null"],"properties":{"action":{"enum":["signup","upgrade"]},"plan":{"enum":["free","broker"]},"name":{"type":"string"},"priceUsdMonthly":{"type":"number"},"apiCallsPerMonth":{"type":"integer"},"url":{"type":"string","format":"uri"}}},"QuotaExhausted":{"type":"object","required":["error","message","scope","limit","used","remaining","resetDate","offer"],"properties":{"error":{"const":"quota_exhausted"},"message":{"type":"string"},"scope":{"enum":["anonymous_daily","account_monthly"]},"limit":{"type":"integer"},"used":{"type":"integer"},"remaining":{"const":0},"resetDate":{"type":["string","null"],"format":"date-time"},"offer":{"$ref":"#/components/schemas/QuotaOffer"},"signupUrl":{"type":"string","format":"uri"},"upgradeUrl":{"type":"string","format":"uri"},"contactUrl":{"type":"string"}}},"Risk":{"type":"object","description":"Risk tier anchored to FMCSA facts. Not a prediction of fraud or an approval.","properties":{"score":{"type":["number","null"],"minimum":0,"maximum":100},"tier":{"enum":["Low","Moderate","High","Extreme","Insufficient data"]},"description":{"type":"string"},"confidence":{"type":"string"},"factors":{"type":"array","items":{"type":"string"}},"methodology":{"type":"string"}},"additionalProperties":true},"CarrierLookup":{"type":"object","required":["success","data"],"properties":{"success":{"const":true},"data":{"type":"object","required":["dot_number","legal_name"],"properties":{"dot_number":{"type":"string"},"mc_number":{"type":["string","null"]},"legal_name":{"type":"string"},"dba_name":{"type":["string","null"]},"address":{"type":"object","properties":{"street":{"type":["string","null"]},"city":{"type":["string","null"]},"state":{"type":["string","null"]},"zip":{"type":["string","null"]}}},"phone":{"type":["string","null"]},"email":{"type":["string","null"]},"fleet":{"type":"object","properties":{"power_units":{"type":["integer","null"]},"drivers":{"type":["integer","null"]}}},"safety":{"type":"object","properties":{"rating":{"type":["string","null"]},"rating_date":{"type":["string","null"]},"out_of_service":{"type":"boolean"},"out_of_service_date":{"type":["string","null"]}}},"basics":{"type":["object","null"],"description":"BASIC percentiles; null when FMCSA publishes none or the snapshot is stale."},"basic_alerts":{"type":"array"},"basic_measures":{"type":["object","null"]},"basic_thresholds":{"type":["object","null"]},"basics_as_of":{"type":["string","null"]},"basics_stale":{"type":"boolean"},"registration":{"type":"object","properties":{"status":{"type":["string","null"]},"allowed_to_operate":{"type":["string","null"]}}},"authority":{"type":"object"},"docket_numbers":{"type":"array"},"cargo_carried":{"type":"array"},"risk":{"$ref":"#/components/schemas/Risk"},"recent_changes":{"type":"object","description":"Recent name/address/phone/email-domain changes and new authority; reports sources it could not check."},"enrichment":{"type":"object","description":"Current FMCSA facts (flags, inspections, authority, registration), each with source and as-of date."},"identity_signals":{"type":"object","description":"Shared-identity signals with evidence."},"metadata":{"type":"object","description":"`last_updated` is the response time, not a government update time.","properties":{"data_source":{"type":"string"},"api_version":{"type":"string"},"last_updated":{"type":"string","format":"date-time"}}}},"additionalProperties":true}},"additionalProperties":true},"SearchResult":{"type":"object","properties":{"dot_number":{"type":"string"},"legal_name":{"type":"string"},"dba_name":{"type":["string","null"]},"physical_address":{"type":["string","null"]},"physical_city":{"type":["string","null"]},"physical_state":{"type":["string","null"]},"physical_zip":{"type":["string","null"]},"phone":{"type":["string","null"]},"power_units":{"type":["integer","null"]},"drivers":{"type":["integer","null"]},"safety_rating":{"type":["string","null"]},"out_of_service_date":{"type":["string","null"]},"authority_status":{"type":["string","null"]},"allowed_to_operate":{"type":["string","null"]},"status":{"type":"string"},"active":{"type":"boolean"}},"additionalProperties":true},"SearchResults":{"type":"object","required":["query","count","total","total_is_minimum","truncated","results"],"properties":{"query":{"type":"string"},"count":{"type":"integer"},"total":{"type":"integer","description":"Matches before the limit."},"total_is_minimum":{"type":"boolean","description":"True when FMCSA capped the candidates, so total is a lower bound."},"truncated":{"type":"boolean"},"results":{"type":"array","items":{"$ref":"#/components/schemas/SearchResult"}}}},"SectionStatus":{"type":"string","description":"Per-section availability, e.g. available, partial, unavailable, not_found, gated."},"CarrierEvidence":{"type":"object","required":["dot_number","status","response_generated_at","carrier","insurance","ucc"],"properties":{"dot_number":{"type":"string"},"status":{"enum":["available","partial"]},"response_generated_at":{"type":"string","format":"date-time"},"carrier":{"type":"object","properties":{"status":{"enum":["available","unavailable","not_found"]},"source_url":{"type":"string"},"field_availability":{"type":"object"},"data":{"type":["object","null"]}},"additionalProperties":true},"insurance":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/SectionStatus"},"policies":{"type":"array"},"source_url":{"type":"string"}},"additionalProperties":true},"ucc":{"type":"object","properties":{"status":{"$ref":"#/components/schemas/SectionStatus"},"filings":{"type":"array"},"total":{"type":["integer","null"]},"next_offset":{"type":["integer","null"]},"batch_id":{"type":"string"},"interpretation":{"type":"string"}},"additionalProperties":true},"company_profile":{"type":"object","additionalProperties":true},"directory_snapshot":{"type":"object","additionalProperties":true},"public_review_evidence":{"type":"object","additionalProperties":true}},"additionalProperties":true},"ContactCheckPart":{"type":"object","properties":{"match":{"enum":["matches_registered","does_not_match","not_provided","invalid","registered_unavailable"]},"other_registrations":{"type":["array","null"],"items":{"type":"object","properties":{"dot_number":{"type":"integer"},"linked_status":{"type":"string"}}}},"other_registrations_total":{"type":["integer","null"]},"shared_widely":{"type":"boolean"},"note":{"type":["string","null"]}}},"ContactCheck":{"type":"object","required":["version","dot_number","phone","email","checked_at"],"properties":{"version":{"const":1},"dot_number":{"type":"integer"},"phone":{"$ref":"#/components/schemas/ContactCheckPart"},"email":{"allOf":[{"$ref":"#/components/schemas/ContactCheckPart"},{"type":"object","properties":{"domain_compared":{"type":"boolean"}}}]},"phone_line_type":{"const":"not_checked"},"source":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"}}},"checked_at":{"type":"string","format":"date-time"}}},"ChangeRow":{"type":"object","properties":{"dot_number":{"type":"string"},"carrier_name":{"type":["string","null"]},"phy_state":{"type":["string","null"]},"change_date":{"type":"string","format":"date"},"field":{"type":"string"},"docket_number":{"type":["string","null"]},"old_value":{"type":["string","null"]},"new_value":{"type":["string","null"]}},"additionalProperties":true},"ChangeList":{"type":"object","required":["kind","window","from","to","total","records"],"properties":{"kind":{"type":"string","enum":["authorities","authority-removed","suspensions","insurance-cancellations","new-registrations"]},"window":{"enum":["day","week"]},"from":{"type":"string","format":"date"},"to":{"type":"string","format":"date"},"total":{"type":"integer"},"records":{"type":"array","items":{"$ref":"#/components/schemas/ChangeRow"}}}}}}}