🧪 List a Carrier’s Insurance Filings

GET

https://api.catenatelematics.com/v2/intelligence/safer/fleets/:dot_number/insurance-filings

GET

/v2/intelligence/safer/fleets/:dot_number/insurance-filings

curl https://api.catenatelematics.com/v2/intelligence/safer/fleets/dot_number/insurance-filings \
     -H "Authorization: Bearer <token>"

{
  "items": [
    {
      "id": "string",
      "registry": "fmcsa",
      "authority_number": "string",
      "created_at": "2024-01-15T09:30:00Z",
      "updated_at": "2024-01-15T09:30:00Z",
      "fleet_registry_id": "string",
      "insurance_type": "bipd",
      "policy_number": "string",
      "effective_date": "2023-01-15",
      "cancellation_date": "2023-01-15",
      "cancellation_method": "cancel",
      "insurer_name": "string",
      "min_coverage_amount": 1
    }
  ],
  "total": 1,
  "current_page": "string",
  "current_page_backwards": "string",
  "previous_page": "string",
  "next_page": "string"
}

Retrieve insurance filings for a carrier, by DOT number. Ordered by effective date, most recent first. Optionally bound the results with from_date/to_date, or set active_only=true to restrict to filings with no cancellation date on file.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

dot_numberstringRequired

Query parameters

registryenumOptional

Registry/authority that maintains the carrier record.

Allowed values:

active_onlybooleanOptionalDefaults to false

If true, only include filings with no cancellation_date on file (i.e. still in force).

from_datedate or nullOptional

Return only records on or after this date. Format: YYYY-MM-DD

to_datedate or nullOptional

Return only records on or before this date. Format: YYYY-MM-DD

cursorstring or nullOptional

Cursor for the next page

sizeintegerOptional1-1000Defaults to 300

Page size

Response

Successful Response

itemslist of objects

totalinteger>=0

current_pagestring or nullOptional

Cursor to refetch the current page

current_page_backwardsstring or nullOptional

Cursor to refetch the current page starting from the last item

previous_pagestring or nullOptional

Cursor for the previous page

next_pagestring or nullOptional

Cursor for the next page

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

405

Method Not Allowed Error

409

Conflict Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error

501

Not Implemented Error