--- title: "List Accidents" method: GET path: "/accidents" tags: ["Accidents"] --- # List Accidents `GET /accidents` ## Request - Base URL: `https://secure.fleetio.com/api` - URL: `https://secure.fleetio.com/api/accidents` - Auth: API key in header `Authorization` and API key in header `Account-Token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Returns a list of Accidents belonging to your account. ## Query parameters - `include_archived` 1 - `start_cursor` string - `per_page` integer - `filter` object - `vehicle_id` EqFilter - `eq` string, required - `driver_id` EqFilter - `eq` string, required - `state` EqFilter - `eq` string, required - `external_id` EqFilter - `eq` string, required - `occurred_at` union - object - `lt` string, required - object - `lte` string, required - object - `gt` string, required - object - `gte` string, required - `created_at` union - object - `lt` string, required - object - `lte` string, required - object - `gt` string, required - object - `gte` string, required - `updated_at` union - object - `lt` string, required - object - `lte` string, required - object - `gt` string, required - object - `gte` string, required - `sort` object - `occurred_at` 'asc' | 'desc' - `updated_at` 'asc' | 'desc' - `created_at` 'asc' | 'desc' - `id` 'asc' | 'desc' ## Response `200` OK - object - `start_cursor` string, nullable: The current start cursor of the records returned. - `next_cursor` string, nullable: The next cursor to retrieve the next page of records. - `per_page` integer: The maximum number of records returned. - `estimated_remaining_count` integer: The number of remaining records including the returned records, up to a maximum of 500. - `filtered_by` union[]: The filters applied to the returned record set. - union - object - `vehicle_id` EqFilter - `eq` string, required - object - `driver_id` EqFilter - `eq` string, required - object - `state` EqFilter - `eq` string, required - object - `external_id` EqFilter - `eq` string, required - object - `occurred_at` union - object - `lt` string, required - object - `lte` string, required - object - `gt` string, required - object - `gte` string, required - object - `created_at` union - object - `lt` string, required - object - `lte` string, required - object - `gt` string, required - object - `gte` string, required - object - `updated_at` union - object - `lt` string, required - object - `lte` string, required - object - `gt` string, required - object - `gte` string, required - `sorted_by` union[]: The sorts applied to the returned record set. - union - object - `id` 'asc' | 'desc' - object - `occurred_at` 'asc' | 'desc' - object - `updated_at` 'asc' | 'desc' - object - `created_at` 'asc' | 'desc' - `records` Accident[] - `id` integer, required: The unique identifier of the Accident. - `state` 'open' | 'closed', required: Whether the Accident is open or closed. - `vehicle_id` integer, required: The id of the Vehicle involved in the Accident. - `driver_id` integer, nullable: The id of the Contact who was driving. - `occurred_at` string, date-time, nullable: The date and time at which the Accident occurred. - `opened_at` string, date-time, nullable: The date and time at which the Accident was opened. - `closed_at` string, date-time, nullable: The date and time at which the Accident was closed. - `closed_by_id` integer, nullable: The id of the User who closed the Accident. - `closed_note` string, nullable: The note recorded when the Accident was closed. - `created_by_id` integer, nullable: The id of the User who created the Accident. - `street_address` string, nullable: The street address where the Accident occurred. - `street_address_line_2` string, nullable: The second line of the street address. - `city` string, nullable: The city where the Accident occurred. - `region` string, nullable: The state, province, or territory where the Accident occurred. - `postal_code` string, nullable: The postal code where the Accident occurred. - `country` string, nullable: The country where the Accident occurred. - `latitude` number, nullable: The latitude where the Accident occurred. - `longitude` number, nullable: The longitude where the Accident occurred. - `detection_source` 'telematics_crash_detection' | 'driver_self_report' | 'dashcam_safety_event' | 'third_party_report' | 'customer_report' | 'insurance_notification', nullable: How the Accident was detected or reported. - `weather` 'clear' | 'rain' | 'snow' | 'fog' | 'sleet' | 'other', nullable: The weather conditions at the time of the Accident. - `road_condition` 'dry' | 'wet' | 'icy' | 'snow_covered' | 'debris' | 'other', nullable: The road conditions at the time of the Accident. - `accident_type` 'rear_end' | 'side_impact' | 'head_on' | 'single_vehicle' | 'backing' | 'parking_lot' | 'hit_and_run' | 'weather_natural_event' | 'vandalism_theft' | 'jobsite_damage' | 'other', nullable: The type of Accident. - `damage_description` string, nullable: A description of the damage. - `driver_statement` string, nullable: The driver's statement about the Accident. - `injuries_reported` 'no_injuries' | 'minor' | 'serious' | 'fatal', nullable: The most serious level of injury reported. - `police_report_number` string, nullable: The police report number. - `other_party_name` string, nullable: The name of the other party involved. - `other_party_phone` string, nullable: The phone number of the other party involved. - `other_party_insurance` string, nullable: The insurance details of the other party involved. - `other_party_vehicle` string, nullable: The vehicle of the other party involved. - `witness_name` string, nullable: The name of a witness. - `witness_contact` string, nullable: The contact details of a witness. - `additional_notes` string, nullable: Additional notes about the Accident. - `insurance_claim_number` string, nullable: The insurance claim number. - `units_involved` integer, nullable: The number of units involved in the Accident. - `total_injured` integer, nullable: The total number of people injured. - `driver_at_fault` boolean, nullable: Whether the driver was at fault. - `total_loss` boolean: Whether the vehicle was a total loss. - `vehicle_operable` boolean, nullable: Whether the vehicle was operable after the Accident. - `external_id` string, nullable: An identifier from an external system. It is set by the API caller and is not unique. - `comments_count` integer: The count of comments on the Accident. - `documents_count` integer: The count of documents on the Accident. - `images_count` integer: The count of images on the Accident. - `vehicle_archived_at` string, date-time, nullable: The date and time at which the Accident's Vehicle was archived. - `created_at` string, date-time: The date and time at which the Accident was created. - `updated_at` string, date-time: The date and time at which the Accident was last updated. - `work_order_id` integer, nullable: The id of the linked Work Order. Null when none is linked or the caller cannot read it. - `service_entry_id` integer, nullable: The id of the linked Service Entry. Null when none is linked or the caller cannot read it. - `assigned_contact_ids` integer[]: The ids of the Contacts assigned to the Accident. - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields). - `vehicle` VehicleMini: A Vehicle - `id` integer, required - `name` string, required: This vehicle's name. - `color` string, nullable: The color of this Vehicle. - `license_plate` string, nullable: The license plate number of this Vehicle. - `vin` string, nullable: The Vehicle Identification Number of this Vehicle. - `year` string, nullable: This Vehicle's model year. - `make` string, nullable: The name of this Vehicle's manufacturer. - `model` string, nullable: The name of the model of this Vehicle. - `trim` string, nullable: The trim level of this Vehicle. - `registration_expiration_month` integer, nullable: The month in which this Vehicle's registration expires. - `registration_state` string, nullable: The state, province, or territory in which this Vehicle is registered. - `default_image_url_small` string, nullable: The URL of a small-sized version of the default image for this Vehicle. - `driver` ContactMini, nullable: A Contact - `id` integer - `email` string, nullable: The Contact's email address. - `name` string, nullable: The Contact's full name. - `group_id` integer, nullable: If this Contact belongs to a [Group](/docs/api/groups), this will be the Fleetio ID of that `Group`. - `employee` boolean, nullable: Whether or not the Contact is an employee. - `employee_number` string, nullable: The employee number of the Contact. - `default_image_url` string, nullable: The URL of the Contact's default image/profile photo, if any. - `assigned_contacts` ContactMini[]: The Contacts assigned to the Accident. The email and employee of each are omitted when the caller's role cannot view basic contact info, and the employee_number of each is omitted when it cannot view contact and personal info. - `id` integer - `email` string, nullable: The Contact's email address. - `name` string, nullable: The Contact's full name. - `group_id` integer, nullable: If this Contact belongs to a [Group](/docs/api/groups), this will be the Fleetio ID of that `Group`. - `employee` boolean, nullable: Whether or not the Contact is an employee. - `employee_number` string, nullable: The employee number of the Contact. - `default_image_url` string, nullable: The URL of the Contact's default image/profile photo, if any. ## Other responses - `400`: The format or parameters of the request was invalid - `401`: Request could not be authenticated - `403`: Insufficient permission to perform this operation - `500`: Something unexpected happened ## Changes - **2026-11-06** `49558d744bd7`: 1 info - endpoint added [Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/accidents/get.md) --- [API](https://skmtc.dev/fleetio/apis/fleetio-developer-api.md) - [All operations](https://skmtc.dev/fleetio/apis/fleetio-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fleetio/apis/fleetio-developer-api/revisions/49558d744bd7?raw)