List Vehicle Renewal Reminders
Returns a list of your Vehicle Renewal Reminders
Query Parameters
- start_cursor string
The start cursor for Keyset pagination.
- per_page integer
Possible values:
>= 2
and<= 100
Default value:
50
The number of records per page to return.
- filter object
The fields, operations, and values to filter the records by.
vehicle_id object
eq string requiredvehicle_renewal_type_id object
eq string requiredactive object
eq string requiredvehicle_renewal_reminder_status object
eq string requiredPossible values: [
ok
,overdue
,due_soon
]due_soon_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt string requiredlte string requiredgt string requiredgte string requiredlast_sent_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt string requiredlte string requiredgt string requiredgte string requirednext_due_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt string requiredlte string requiredgt string requiredgte string requiredcreated_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt string requiredlte string requiredgt string requiredgte string requiredupdated_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt string requiredlte string requiredgt string requiredgte string required
- sort object
The fields and direction to sort the results by.
- id string
Possible values: [
asc
,desc
]Default value:
desc
- due_soon_at string
Possible values: [
asc
,desc
] - last_sent_at string
Possible values: [
asc
,desc
] - next_due_at string
Possible values: [
asc
,desc
] - created_at string
Possible values: [
asc
,desc
] - updated_at string
Possible values: [
asc
,desc
]
- 200
- 400
- 401
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
- start_cursor string
The current start cursor of the records returned.
- next_cursor string
The next cursor to retrieve the next page of records.
- per_page integer
The maxumum 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 object[]
The filters applied to the returned record set.
anyOf- MOD1
- MOD2
- MOD3
- MOD4
- MOD5
- MOD6
- MOD7
- MOD8
- MOD9
vehicle_id object
eq stringvehicle_renewal_type_id object
eq stringactive object
eq stringvehicle_renewal_reminder_status object
eq stringPossible values: [
ok
,overdue
,due_soon
]due_soon_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt stringlte stringgt stringgte stringlast_sent_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt stringlte stringgt stringgte stringnext_due_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt stringlte stringgt stringgte stringcreated_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt stringlte stringgt stringgte stringupdated_at object
oneOf- MOD1
- MOD2
- MOD3
- MOD4
lt stringlte stringgt stringgte stringsorted_by object[]
The sorts applied to the returned record set.
anyOf- MOD1
- MOD2
- MOD3
- MOD4
- MOD5
- MOD6
due_soon_at stringPossible values: [
asc
,desc
]last_sent_at stringPossible values: [
asc
,desc
]next_due_at stringPossible values: [
asc
,desc
]created_at stringPossible values: [
asc
,desc
]updated_at stringPossible values: [
asc
,desc
]id stringPossible values: [
asc
,desc
]records object[]
vehicle_id integervehicle_renewal_type_id integervehicle_archived_at date-timeThe date and time at which this Renewal Reminder's Vehicle was archived, if applicable.
comments_count integerThe number of
Comments
on this Renewal Reminder.active booleanWhether or not this Renewal Reminder is active.
next_due_at date-timeThe date and time at which this Renewal Reminder is next due.
last_sent_at date-timeThe date and time at which this Renewal Reminder was last sent.
due_soon_at date-timeThe date and time at which this Renewal Reminder will next be marked as "Due Soon".
due_soon_time_threshold_interval integerThe amount of time before a Renewal is due where it will be marked as as "Due Soon".
due_soon_time_threshold_frequency stringPossible values: [
day
,week
,month
,year
,days
,weeks
,months
,years
]vehicle_renewal_reminder_status stringPossible values: [
ok
,overdue
,due_soon
]The current status of this Vehicle Renewal Reminder.
attachment_permissions object
read_photos booleanIndicates whether the user has read permission for photos.
manage_photos booleanIndicates whether the user has permission to manage (eg. upload, delete) photos.
read_documents booleanIndicates whether the user has read permission for documents.
manage_documents booleanIndicates whether the user has permission to manage (eg. upload, delete) documents.
custom_fields object*Full details on working with Custom Fields here.
vehicle object
A Vehicle
id integername stringThis vehicle's name.
color stringThe color of this Vehicle.
license_plate stringThe license plate number of this Vehicle.
vin stringThe Vehicle Identification Number of this Vehicle.
year stringThis Vehicle's model year.
make stringThe name of this Vehicle's manufacturer.
model stringThe name of the model of this Vehicle.
trim stringThe trim level of this Vehicle.
registration_expiration_month integerPossible values:
<= 12
The month in which this Vehicle's registration expires.
registration_state stringThe state, province, or territory in which this Vehicle is registered.
default_image_url_small stringThe URL of a small-sized version of the default image for this Vehicle.
{
"start_cursor": "string",
"next_cursor": "string",
"per_page": 0,
"estimated_remaining_count": 0,
"filtered_by": [
{
"vehicle_id": {
"eq": "string"
}
},
{
"vehicle_renewal_type_id": {
"eq": "string"
}
},
{
"active": {
"eq": "string"
}
},
{
"vehicle_renewal_reminder_status": {
"eq": "ok"
}
},
{
"due_soon_at": {
"lt": "string"
}
},
{
"last_sent_at": {
"lt": "string"
}
},
{
"next_due_at": {
"lt": "string"
}
},
{
"created_at": {
"lt": "string"
}
},
{
"updated_at": {
"lt": "string"
}
}
],
"sorted_by": [
{
"due_soon_at": "asc"
},
{
"last_sent_at": "asc"
},
{
"next_due_at": "asc"
},
{
"created_at": "asc"
},
{
"updated_at": "asc"
},
{
"id": "asc"
}
],
"records": [
{
"vehicle_id": 0,
"vehicle_renewal_type_id": 0,
"vehicle_archived_at": "2023-03-14T13:46:27-06:00",
"comments_count": 0,
"active": true,
"next_due_at": "2023-03-14T13:46:27-06:00",
"last_sent_at": "2023-03-14T13:46:27-06:00",
"due_soon_at": "2023-03-14T13:46:27-06:00",
"due_soon_time_threshold_interval": 0,
"due_soon_time_threshold_frequency": "day",
"vehicle_renewal_reminder_status": "ok",
"attachment_permissions": {
"read_photos": true,
"manage_photos": true,
"read_documents": true,
"manage_documents": true
},
"custom_fields": {},
"vehicle": {
"id": 0,
"name": "string",
"color": "string",
"license_plate": "string",
"vin": "string",
"year": "string",
"make": "string",
"model": "string",
"trim": "string",
"registration_expiration_month": 0,
"registration_state": "string",
"default_image_url_small": "string"
}
}
]
}
The format or parameters of the request was invalid
- application/json
- Schema
- Example (from schema)
Schema
errors object
typeitems string
{
"errors": {}
}
Request could not be authenticated
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}
Something unexpected happened
- application/json
- Schema
- Example (from schema)
Schema
- status integer
Possible values:
>= 400
and<= 599
- title string
A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localization.
- detail string
A human-readable explanation specific to this occurrence of the problem.
- instance string
A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.
{
"status": 0,
"title": "string",
"detail": "string",
"instance": "string"
}