--- title: "List Vehicle Renewal Reminders" method: GET path: "/vehicle_renewal_reminders" tags: ["Vehicle Renewal Reminders"] --- # List Vehicle Renewal Reminders `GET /vehicle_renewal_reminders` ## Request - Base URL: `https://secure.fleetio.com/api` - URL: `https://secure.fleetio.com/api/vehicle_renewal_reminders` - 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 your Vehicle Renewal Reminders ## Query parameters - `start_cursor` string - `per_page` integer - `filter` object - `vehicle_id` EqFilter - `eq` string, required - `vehicle_renewal_type_id` EqFilter - `eq` string, required - `active` EqFilter - `eq` string, required - `vehicle_renewal_reminder_status` VehicleRenewalReminderStatusFilter - `eq` 'ok' | 'overdue' | 'due_soon', required - `due_soon_at` union - object - `lt` string, required - object - `lte` string, required - object - `gt` string, required - object - `gte` string, required - `last_sent_at` union - object - `lt` string, required - object - `lte` string, required - object - `gt` string, required - object - `gte` string, required - `next_due_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 - `id` 'asc' | 'desc' - `due_soon_at` 'asc' | 'desc' - `last_sent_at` 'asc' | 'desc' - `next_due_at` 'asc' | 'desc' - `created_at` 'asc' | 'desc' - `updated_at` '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 - `vehicle_renewal_type_id` EqFilter - `eq` string, required - object - `active` EqFilter - `eq` string, required - object - `vehicle_renewal_reminder_status` VehicleRenewalReminderStatusFilter - `eq` 'ok' | 'overdue' | 'due_soon', required - object - `due_soon_at` union - object - `lt` string, required - object - `lte` string, required - object - `gt` string, required - object - `gte` string, required - object - `last_sent_at` union - object - `lt` string, required - object - `lte` string, required - object - `gt` string, required - object - `gte` string, required - object - `next_due_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 - `due_soon_at` 'asc' | 'desc' - object - `last_sent_at` 'asc' | 'desc' - object - `next_due_at` 'asc' | 'desc' - object - `created_at` 'asc' | 'desc' - object - `updated_at` 'asc' | 'desc' - object - `id` 'asc' | 'desc' - `records` VehicleRenewalReminderSummary[] - `vehicle_id` integer, required - `vehicle_renewal_type_id` integer, required - `vehicle_archived_at` string, date-time, nullable, required: The date and time at which this Renewal Reminder's Vehicle was archived, if applicable. - `comments_count` integer, nullable, required: The number of `Comments` on this Renewal Reminder. - `active` boolean, nullable, required: Whether or not this Renewal Reminder is active. - `next_due_at` string, date-time, required: The date and time at which this Renewal Reminder is next due. - `last_sent_at` string, date-time, nullable, required: The date and time at which this Renewal Reminder was last sent. - `due_soon_at` string, date-time, nullable, required: The date and time at which this Renewal Reminder will next be marked as "Due Soon". - `due_soon_time_threshold_interval` integer, nullable, required: The amount of time before a Renewal is due where it will be marked as as "Due Soon". - `due_soon_time_threshold_frequency` 'day' | 'week' | 'month' | 'year' | 'days' | 'weeks' | 'months' | 'years', nullable, required - `vehicle_renewal_reminder_status` 'ok' | 'overdue' | 'due_soon', required: The current status of this Vehicle Renewal Reminder. - `attachment_permissions` AttachmentPermissions, nullable - `read_photos` boolean: Indicates whether the user has read permission for photos. - `manage_photos` boolean: Indicates whether the user has permission to manage (eg. upload, delete) photos. - `read_documents` boolean: Indicates whether the user has read permission for documents. - `manage_documents` boolean: Indicates whether the user has permission to manage (eg. upload, delete) documents. - `custom_fields` CustomFields, nullable: *Full details on working with Custom Fields [here](/docs/overview/custom-fields). - `vehicle` VehicleMini, required: 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. ## Other responses - `400`: The format or parameters of the request was invalid - `401`: Request could not be authenticated - `500`: Something unexpected happened ## Changes - **2026-11-06** `49558d744bd7`: 1 info - for the `query` request parameter `per_page`, the min was decreased from `2.00` to `1.00` [Operation history](https://skmtc.dev/fleetio/apis/fleetio-developer-api/changes/vehicle_renewal_reminders/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)