Skip to main content

Update Work Order

Update a Work Order

Path Parameters

  • id string required

    Possible values: Value must match regular expression ^[0-9]+$

    The id of the relevant record

Request Body

  • issued_at date-time

    The date and time at which this Work Order was issued. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • started_at date-time

    The date and time at which this Work Order was started. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • completed_at date-time

    The date and time at which this Work Order was completed. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • work_order_status_id integer

    Possible values: >= 1

  • invoice_number string

    Possible values: <= 255 characters

    The number of the Invoice associated with this Work Order.

  • vendor_id NullableId

    Possible values: >= 1

  • vendor_name string

    Possible values: <= 255 characters

    The name of the Vendor associated with this Work Order.

  • vehicle_id integer

    Possible values: >= 1

  • vehicle_name string

    Possible values: <= 255 characters

    The name of the Vehicle associated with this Work Order.

  • discount_type string

    Possible values: [percentage, amount]

    The type of discount applied to this Work Order.

  • discount float

    The discount amount in decimal currency units applied to this Work Order.

  • discount_percentage float

    The percentage of the discount applied to this Work Order. Used if discount_type is set to percentage.

  • tax_1_percentage float

    The percentage of the first tax applied to this Work Order. Used if tax_1_type is set to percentage.

  • tax_1_type string

    Possible values: [fixed, percentage]

    Default value: percentage

    The type of tax to apply to this record.

  • tax_1 float

    The amount of the first tax applied to this Work Order. Used if tax_1_type is set to amount.

  • tax_2_percentage float

    The percentage of the second tax applied to this Work Order. Used if tax_2_type is set to percentage.

  • tax_2_type string

    Possible values: [fixed, percentage]

    Default value: percentage

    The type of tax to apply to this record.

  • tax_2 float

    The amount of the second tax applied to this Work Order. Used if tax_2_type is set to amount.

  • issued_by_id NullableId

    Possible values: >= 1

  • contact_id NullableId

    Possible values: >= 1

  • label_list string

    Possible values: <= 255 characters

    A comma separated list of tags associated with this record. The only delimiter allowed is a comma (,). Please remove any commas from your labels before saving the record.

  • purchase_order_number string

    The number of the Purchase Order associated with this Work Order.

  • description string

    A description of this Work Order.

  • number integer

    The number to be applied to this Work Order. Must be unique.

  • meter_entry_attributes object

    A Work Order may also be associated with a Meter Entry.

  • value float

    The value is the actual number on the meter that increments over time. The unit is determined by the configured meter_unit on the associated Vehicle.

  • void boolean

    If you attempt to save a meter value, which is too high or too low, Fleetio's validation rules will reject it. If you need to bypass this validation, you may mark an entry as void.

  • secondary_meter_entry_attributes object

    A Work Order may also be associated with a secondary Meter Entry.

  • value float

    The value is the actual number on the meter that increments over time. The unit is determined by the configured meter_unit on the associated Vehicle.

  • void boolean

    If you attempt to save a meter value, which is too high or too low, Fleetio's validation rules will reject it. If you need to bypass this validation, you may mark an entry as void.

  • starting_meter_entry_attributes object

    The meter reading at the start of this Work Order.

  • value float

    The value is the actual number on the meter that increments over time. The unit is determined by the configured meter_unit on the associated Vehicle.

  • void boolean

    If you attempt to save a meter value, which is too high or too low, Fleetio's validation rules will reject it. If you need to bypass this validation, you may mark an entry as void.

  • ending_meter_entry_attributes object

    The meter reading at the end of this Work Order.

  • value float

    The value is the actual number on the meter that increments over time. The unit is determined by the configured meter_unit on the associated Vehicle.

  • void boolean

    If you attempt to save a meter value, which is too high or too low, Fleetio's validation rules will reject it. If you need to bypass this validation, you may mark an entry as void.

  • starting_secondary_meter_entry_attributes object

    The secondary meter reading at the start of this Work Order.

  • value float

    The value is the actual number on the meter that increments over time. The unit is determined by the configured meter_unit on the associated Vehicle.

  • void boolean

    If you attempt to save a meter value, which is too high or too low, Fleetio's validation rules will reject it. If you need to bypass this validation, you may mark an entry as void.

  • ending_secondary_meter_entry_attributes object

    The secondary meter reading at the end of this Work Order.

  • value float

    The value is the actual number on the meter that increments over time. The unit is determined by the configured meter_unit on the associated Vehicle.

  • void boolean

    If you attempt to save a meter value, which is too high or too low, Fleetio's validation rules will reject it. If you need to bypass this validation, you may mark an entry as void.

  • custom_fields object

    *Full details on working with Custom Fields here.

  • ending_meter_same_as_start boolean

    Use start meter for completion meter?

  • vmrs_repair_priority_class_id NullableId

    Possible values: >= 1

  • scheduled_at date-time

    The date and time at which this Work Order is scheduled. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • expected_completed_at date-time

    The date and time at which this Work Order is expected to be completed. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • comments_attributes object[]

    A list of Comments to be added to this Work Order.

  • title string

    The title of the comment.

  • comment string

    The comment text.

  • work_order_line_items_attributes object[]

    A list of Work Order Line Items to be added to this Work Order.

  • id integer

    The ID of this Work Order Line Item. Required if this is a Work Order Line Item being updated.

  • item_type string

    Possible values: [Issue, ServiceTask]

    The Type of the item associated with this Work Order Line Item.

  • item_name string

    The name of the item associated with this Work Order Line Item.

  • description string

    A description of this Work Order Line Item.

  • item_id integer

    The ID of the item associated with this Work Order Line Item.

  • labor_cost float

    The cost of labor of this line item.

  • parts_cost float

    The cost of Parts of this line item.

  • position integer

    The position of this line item in a list of line items.

  • subtotal float

    The subtotal of this line item.

  • type string

    Possible values: [WorkOrderServiceTaskLineItem, WorkOrderFreeTextLineItem]

  • vmrs_reason_for_repair_id integer

    The ID of the VMRS Reason for Repair associated with this Work Order Line Item.

  • vmrs_system_group_id integer

    The ID of the VMRS System Group associated with this Work Order Line Item.

  • vmrs_system_id integer

    The ID of the VMRS System associated with this Work Order Line Item.

  • vmrs_assembly_id integer

    The ID of the VMRS Assembly associated with this Work Order Line Item.

  • vmrs_component_id integer

    The ID of the VMRS Component associated with this Work Order Line Item.

  • issue_ids integer[]

    The IDs of any Issues associated with this Work Order Line Item.

  • work_order_sub_line_items_attributes object[]

    A list of any Work Order Sub Line Items to be added.

  • id integer

    The ID of this Work Order Sub Line Item. Required if this is a Work Order Sub Line Item being updated.

  • type string

    Possible values: [WorkOrderPartLineItem, WorkOrderLaborLineItem]

  • item_id integer

    The ID of the Part or Contact associated with this Work Order Line Item.

  • item_type string

    Possible values: [Part, Contact]

  • quantity float

    The quantity of the Part or Contact associated with this Work Order Line Item.

  • part_location_detail_id integer

    This ID refers to the details of the Part at a specific Part Location. You can send a GET request to https://secure.fleetio.com/api/v1/parts/:id to get any part_location_detail_id(s) for a Part. The id attribute under the part_locations object is the value that corresponds to this parameter.

  • position integer

    The position of this Work Order Line Item in a list of line items.

  • description string

    The description of this Work Order Line Item.

  • inventory_set_id integer

    The ID of the Inventory Set associated with this Work Order Line Item. This is only required if the Part is associated with an Inventory Set.

  • vmrs_reason_for_repair_id integer

    The ID of the VMRS Reason for Repair associated with this Work Order Line Item.

  • vmrs_system_group_id integer

    The ID of the VMRS System Group associated with this Work Order Line Item.

  • vmrs_system_id integer

    The ID of the VMRS System associated with this Work Order Line Item.

  • vmrs_assembly_id integer

    The ID of the VMRS Assembly associated with this Work Order Line Item.

  • vmrs_component_id integer

    The ID of the VMRS Component associated with this Work Order Line Item.

  • labor_time_entries_attributes object[]
  • started_at date-time

    The date and time at which this Labor Time Entry was started. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • ended_at date-time

    The date and time at which this Labor Time Entry was ended. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • contact_id NullableId

    Possible values: >= 1

  • work_order_part_line_items_attributes object[]

    A list of any Work Order Part Line Items to be added.

  • id integer

    The ID of this Work Order Sub Line Item. Required if this is a Work Order Sub Line Item being updated.

  • type string

    Possible values: [WorkOrderPartLineItem, WorkOrderLaborLineItem]

  • item_id integer

    The ID of the Part or Contact associated with this Work Order Line Item.

  • item_type string

    Possible values: [Part, Contact]

  • quantity float

    The quantity of the Part or Contact associated with this Work Order Line Item.

  • part_location_detail_id integer

    This ID refers to the details of the Part at a specific Part Location. You can send a GET request to https://secure.fleetio.com/api/v1/parts/:id to get any part_location_detail_id(s) for a Part. The id attribute under the part_locations object is the value that corresponds to this parameter.

  • position integer

    The position of this Work Order Line Item in a list of line items.

  • description string

    The description of this Work Order Line Item.

  • inventory_set_id integer

    The ID of the Inventory Set associated with this Work Order Line Item. This is only required if the Part is associated with an Inventory Set.

  • vmrs_reason_for_repair_id integer

    The ID of the VMRS Reason for Repair associated with this Work Order Line Item.

  • vmrs_system_group_id integer

    The ID of the VMRS System Group associated with this Work Order Line Item.

  • vmrs_system_id integer

    The ID of the VMRS System associated with this Work Order Line Item.

  • vmrs_assembly_id integer

    The ID of the VMRS Assembly associated with this Work Order Line Item.

  • vmrs_component_id integer

    The ID of the VMRS Component associated with this Work Order Line Item.

  • labor_time_entries_attributes object[]
  • started_at date-time

    The date and time at which this Labor Time Entry was started. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • ended_at date-time

    The date and time at which this Labor Time Entry was ended. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • contact_id NullableId

    Possible values: >= 1

  • work_order_labor_line_items_attributes object[]

    A list of any Work Order Labor Line Items to be added.

  • id integer

    The ID of this Work Order Sub Line Item. Required if this is a Work Order Sub Line Item being updated.

  • type string

    Possible values: [WorkOrderPartLineItem, WorkOrderLaborLineItem]

  • item_id integer

    The ID of the Part or Contact associated with this Work Order Line Item.

  • item_type string

    Possible values: [Part, Contact]

  • quantity float

    The quantity of the Part or Contact associated with this Work Order Line Item.

  • part_location_detail_id integer

    This ID refers to the details of the Part at a specific Part Location. You can send a GET request to https://secure.fleetio.com/api/v1/parts/:id to get any part_location_detail_id(s) for a Part. The id attribute under the part_locations object is the value that corresponds to this parameter.

  • position integer

    The position of this Work Order Line Item in a list of line items.

  • description string

    The description of this Work Order Line Item.

  • inventory_set_id integer

    The ID of the Inventory Set associated with this Work Order Line Item. This is only required if the Part is associated with an Inventory Set.

  • vmrs_reason_for_repair_id integer

    The ID of the VMRS Reason for Repair associated with this Work Order Line Item.

  • vmrs_system_group_id integer

    The ID of the VMRS System Group associated with this Work Order Line Item.

  • vmrs_system_id integer

    The ID of the VMRS System associated with this Work Order Line Item.

  • vmrs_assembly_id integer

    The ID of the VMRS Assembly associated with this Work Order Line Item.

  • vmrs_component_id integer

    The ID of the VMRS Component associated with this Work Order Line Item.

  • labor_time_entries_attributes object[]
  • started_at date-time

    The date and time at which this Labor Time Entry was started. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • ended_at date-time

    The date and time at which this Labor Time Entry was ended. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • contact_id NullableId

    Possible values: >= 1

  • work_order_sub_line_items_attributes object[]

    A list of Work Order Sub Line Items to be added to this Work Order.

  • id integer

    The ID of this Work Order Sub Line Item. Required if this is a Work Order Sub Line Item being updated.

  • type string

    Possible values: [WorkOrderPartLineItem, WorkOrderLaborLineItem]

  • item_id integer

    The ID of the Part or Contact associated with this Work Order Line Item.

  • item_type string

    Possible values: [Part, Contact]

  • quantity float

    The quantity of the Part or Contact associated with this Work Order Line Item.

  • part_location_detail_id integer

    This ID refers to the details of the Part at a specific Part Location. You can send a GET request to https://secure.fleetio.com/api/v1/parts/:id to get any part_location_detail_id(s) for a Part. The id attribute under the part_locations object is the value that corresponds to this parameter.

  • position integer

    The position of this Work Order Line Item in a list of line items.

  • description string

    The description of this Work Order Line Item.

  • inventory_set_id integer

    The ID of the Inventory Set associated with this Work Order Line Item. This is only required if the Part is associated with an Inventory Set.

  • vmrs_reason_for_repair_id integer

    The ID of the VMRS Reason for Repair associated with this Work Order Line Item.

  • vmrs_system_group_id integer

    The ID of the VMRS System Group associated with this Work Order Line Item.

  • vmrs_system_id integer

    The ID of the VMRS System associated with this Work Order Line Item.

  • vmrs_assembly_id integer

    The ID of the VMRS Assembly associated with this Work Order Line Item.

  • vmrs_component_id integer

    The ID of the VMRS Component associated with this Work Order Line Item.

  • labor_time_entries_attributes object[]
  • started_at date-time

    The date and time at which this Labor Time Entry was started. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • ended_at date-time

    The date and time at which this Labor Time Entry was ended. We recommend using ISO-8601 formatted dates to avoid ambiguity.

  • contact_id NullableId

    Possible values: >= 1

  • issue_ids NullableId[]

    Possible values: >= 1

    A list of Issues to be added to this Work Order.

  • label_ids NullableId[]

    Possible values: >= 1

    A list of Labels to be added to this Work Order.

  • documents_attributes object[]

    An array of one or more document objects to add to the record. Follow our Attaching Documents and Images guide to upload to our third party storage provider in order to obtain file_url.

  • name string

    Possible values: <= 255 characters

    The name to give the file which will be shown in the UI.

  • file_url string

    Possible values: <= 255 characters

    The URL obtained from our storage provider that points to the file.

  • file_mime_type string

    Possible values: <= 255 characters

    The MIME type of the file. For example, application/pdf.

  • file_name string

    Possible values: <= 255 characters

    The name of the file.

  • file_size integer

    The size of the file in bytes.

  • images_attributes object[]

    An array of one or more image objects to add to the record. Follow our Attaching Documents and Images guide to upload to our third party storage provider in order to obtain file_url.

  • name string

    Possible values: <= 255 characters

    The name to give the image which will be shown in the UI.

  • file_url string

    Possible values: <= 255 characters

    The URL obtained from our storage provider that points to the image.

  • file_mime_type string

    Possible values: <= 255 characters

    The MIME type of the image. For example, image/png.

  • file_name string

    Possible values: <= 255 characters

    The name of the image.

  • file_size integer

    The size of the image file in bytes.

Responses

OK


Schema

  • id integer

    Possible values: >= 1

  • created_at date-time

    The date and time at which this record was created.

  • updated_at date-time

    The date and time at which this record was most recently updated.

  • number string

    The unique number of this Work Order.

  • completed_at date-time

    The date and time at which the Work Order was completed.

  • description string

    A description of this Work Order.

  • ending_meter_same_as_start boolean

    Indicates whether or not the ending meter is the same as the starting meter.

  • duration_in_seconds integer

    The number of seconds elapsed between beginning this Work Order and completing it.

  • invoice_number string

    The number of the Invoice associated with this Work Order.

  • state string

    Possible values: [active, completed]

    Indicates whether this Work Order is currently active or has already been completed.

  • issued_at date-time

    The date and time at which the Work Order was issued.

  • issued_by_id NullableId

    Possible values: >= 1

  • issued_by_name string

    The name of the Contact associated with the User who issued this Work Order.

  • contact_id NullableId

    Possible values: >= 1

  • contact_name string

    The name of the Contact currently assigned to this Work Order.

  • purchase_order_number string

    The number of any Purchase Order associated with this Work Order.

  • started_at date-time

    The date and time at which the Work Order was started.

  • expected_completed_at date-time

    The date and time at which the Work Order is expected to be completed.

  • contact_image_url string

    The URL of the image associated with the Contact currently assigned to this Work Order.

  • work_order_sub_line_items object[]
    anyOf

  • id integer

    Possible values: >= 1

  • created_at date-time

    The date and time at which this record was created.

  • updated_at date-time

    The date and time at which this record was most recently updated.

  • description string

    The description of the sub line item.

  • item_id integer

    Possible values: >= 1

  • item_type string

    Possible values: [Contact]

  • work_order_line_item_id NullableId

    Possible values: >= 1

  • quantity float

    The quantity of this sub line item.

  • part_location_detail_id NullableId

    Possible values: >= 1

  • position integer

    The position of this sub line item in a list of sub line items.

  • item_name string

    The name of this sub line item.

  • unit_cost float

    The unit cost of this sub line item.

  • contact object

    A Contact

  • id integer
  • created_at date-time
  • updated_at date-time
  • email string

    The Contact's email address.

  • name string

    The Contact's full name.

  • first_name string

    The Contact's first name.

  • middle_name string

    The Contact's middle name.

  • last_name string

    The Contact's last name.

  • images_count integer

    The number of images associated with this Contact.

  • documents_count integer

    The number of documents associated with this Contact.

  • comments_count integer

    The number of comments associated with this Contact.

  • group_id integer

    If this Contact belongs to a Group, this will be the Fleetio ID of that Group.

  • group_name string

    If this Contact belongs to a Group, this will be the Group's name.

  • group_hierarchy string

    If this Contact belongs to a Group, this will be a pipe delimited string representing the Group hierarchy. Each Group in the list is the parent of the Groups which follow.

  • technician boolean

    Whether or not the Contact is a Technician.

  • vehicle_operator boolean

    Whether or not the Contact is a Vehicle Operator.

  • employee boolean

    Whether or not the Contact is an Employee.

  • birth_date date

    The Contact's birth date.

  • street_address string

    The Contact's street address.

  • street_address_line_2 string

    The Contact's street address line 2.

  • city string

    The Contact's city.

  • region string

    The Contact's region, state, or province.

  • postal_code string

    The Contact's postal code, zip code, or equivalent.

  • country string

    The Contact's country.

  • employee_number string

    The Contact's employee number.

  • job_title string

    Possible values: <= 255 characters

    The Contact's job title.

  • license_class string

    The Contact's driver's license class.

  • license_number string

    The Contact's driver's license number.

  • license_state string

    The locality which issued the Contact's license.

  • license_expiration date

    The Contact's driver's license expiration date.

  • home_phone_number string

    The Contact's home phone number.

  • mobile_phone_number string

    The Contact's mobile phone number.

  • work_phone_number string

    The Contact's work phone number.

  • other_phone_number string

    Any other phone number for this Contact.

  • start_date date

    When the Contact started working for the company, if applicable.

  • leave_date date

    When the Contact left or will leave the company, if applicable.

  • hourly_labor_rate float

    The Contact's hourly rate.

  • custom_fields object

    *Full details on working with Custom Fields here.

  • attachment_permissions object
  • 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.

  • default_image_url string

    The URL of the Contact's default image/profile photo, if any.

  • user object

    If the Contact is a Fleetio User, those details will be included here.

  • account_membership_id NullableId

    Possible values: >= 1

  • labor_time_entries object[]
  • id integer

    Possible values: >= 1

  • created_at date-time

    The date and time at which this record was created.

  • updated_at date-time

    The date and time at which this record was most recently updated.

  • account_id integer

    Possible values: >= 1

  • contact_id integer

    Possible values: >= 1

  • duration_in_seconds integer
  • ended_at date-time
  • laborable_id integer

    Possible values: >= 1

  • laborable_type string

    Possible values: [WorkOrderSubLineItem]

  • started_at date-time
  • data object
  • clock_in_latitude float
  • clock_in_longitude float
  • clock_out_latitude float
  • clock_out_longitude float
  • active boolean

    Indicates whether this Labor Time Entry is active.

  • scheduled_at date-time

    The date and time at which the Work Order was scheduled.

  • vehicle_id integer

    Possible values: >= 1

  • vehicle_name string

    The name of the Vehicle associated with this Work Order.

  • vendor_id NullableId

    Possible values: >= 1

  • vendor_name string

    The name of the Vendor associated with this Work Order.

  • work_order_status_id integer

    Possible values: >= 1

  • work_order_status_name string

    The name of the Work Order Status associated with this Work Order.

  • work_order_status_color string

    The color of the Work Order Status seen in the UI.

  • custom_fields object

    *Full details on working with Custom Fields here.

  • work_order_line_items object[]
  • id integer

    Possible values: >= 1

  • created_at date-time

    The date and time at which this record was created.

  • updated_at date-time

    The date and time at which this record was most recently updated.

  • description string

    A description of this Work Order Line Item.

  • title string

    The title of this Work Order Line Item.

  • item_id integer

    The ID of the item associated with this Work Order Line Item.

  • item_type string

    Possible values: [Issue, ServiceTask]

    The type of item associated with this Work Order Line Item.

  • work_order_line_item_id integer
  • item_name string

    The name of the item associated with this Work Order Line Item.

  • position integer

    The position of this Work Order Line Item in a list of Work Order Line Items.

  • issues object[]

    Any Issues associated with this Work Order Line Item.

  • id integer

    The ID of the Issue.

  • name string

    The name of the Issue.

  • vmrs_reason_for_repair object
  • account_id integer
  • alias string
  • code string
  • enabled boolean
  • id integer
  • name string
  • repair_type string
  • standard boolean
  • standard_name string
  • type string
  • vmrs_standard_reason_for_repair object
  • vmrs_system_group object
  • account_id number
  • assembly_code string
  • assembly_name string
  • code_type string

    Possible values: [system_group, system, assembly, component]

  • component_code string
  • component_name string
  • enabled boolean
  • id integer
  • permissions object
  • destroy boolean
  • standard boolean
  • system_code string
  • system_group string
  • system_group_code string
  • system_name string
  • type string
  • vmrs_standard_system_assembly_component object
  • vmrs_system object
  • account_id number
  • assembly_code string
  • assembly_name string
  • code_type string

    Possible values: [system_group, system, assembly, component]

  • component_code string
  • component_name string
  • enabled boolean
  • id integer
  • permissions object
  • destroy boolean
  • standard boolean
  • system_code string
  • system_group string
  • system_group_code string
  • system_name string
  • type string
  • vmrs_standard_system_assembly_component object
  • vmrs_assembly object
  • account_id number
  • assembly_code string
  • assembly_name string
  • code_type string

    Possible values: [system_group, system, assembly, component]

  • component_code string
  • component_name string
  • enabled boolean
  • id integer
  • permissions object
  • destroy boolean
  • standard boolean
  • system_code string
  • system_group string
  • system_group_code string
  • system_name string
  • type string
  • vmrs_standard_system_assembly_component object
  • vmrs_component object
  • account_id number
  • assembly_code string
  • assembly_name string
  • code_type string

    Possible values: [system_group, system, assembly, component]

  • component_code string
  • component_name string
  • enabled boolean
  • id integer
  • permissions object
  • destroy boolean
  • standard boolean
  • system_code string
  • system_group string
  • system_group_code string
  • system_name string
  • type string
  • vmrs_standard_system_assembly_component object
  • work_order_sub_line_items object[]
    anyOf

  • id integer

    Possible values: >= 1

  • created_at date-time

    The date and time at which this record was created.

  • updated_at date-time

    The date and time at which this record was most recently updated.

  • description string

    The description of the sub line item.

  • item_id integer

    Possible values: >= 1

  • item_type string

    Possible values: [Contact]

  • work_order_line_item_id NullableId

    Possible values: >= 1

  • quantity float

    The quantity of this sub line item.

  • part_location_detail_id NullableId

    Possible values: >= 1

  • position integer

    The position of this sub line item in a list of sub line items.

  • item_name string

    The name of this sub line item.

  • unit_cost float

    The unit cost of this sub line item.

  • contact object

    A Contact

  • id integer
  • created_at date-time
  • updated_at date-time
  • email string

    The Contact's email address.

  • name string

    The Contact's full name.

  • first_name string

    The Contact's first name.

  • middle_name string

    The Contact's middle name.

  • last_name string

    The Contact's last name.

  • images_count integer

    The number of images associated with this Contact.

  • documents_count integer

    The number of documents associated with this Contact.

  • comments_count integer

    The number of comments associated with this Contact.

  • group_id integer

    If this Contact belongs to a Group, this will be the Fleetio ID of that Group.

  • group_name string

    If this Contact belongs to a Group, this will be the Group's name.

  • group_hierarchy string

    If this Contact belongs to a Group, this will be a pipe delimited string representing the Group hierarchy. Each Group in the list is the parent of the Groups which follow.

  • technician boolean

    Whether or not the Contact is a Technician.

  • vehicle_operator boolean

    Whether or not the Contact is a Vehicle Operator.

  • employee boolean

    Whether or not the Contact is an Employee.

  • birth_date date

    The Contact's birth date.

  • street_address string

    The Contact's street address.

  • street_address_line_2 string

    The Contact's street address line 2.

  • city string

    The Contact's city.

  • region string

    The Contact's region, state, or province.

  • postal_code string

    The Contact's postal code, zip code, or equivalent.

  • country string

    The Contact's country.

  • employee_number string

    The Contact's employee number.

  • job_title string

    Possible values: <= 255 characters

    The Contact's job title.

  • license_class string

    The Contact's driver's license class.

  • license_number string

    The Contact's driver's license number.

  • license_state string

    The locality which issued the Contact's license.

  • license_expiration date

    The Contact's driver's license expiration date.

  • home_phone_number string

    The Contact's home phone number.

  • mobile_phone_number string

    The Contact's mobile phone number.

  • work_phone_number string

    The Contact's work phone number.

  • other_phone_number string

    Any other phone number for this Contact.

  • start_date date

    When the Contact started working for the company, if applicable.

  • leave_date date

    When the Contact left or will leave the company, if applicable.

  • hourly_labor_rate float

    The Contact's hourly rate.

  • custom_fields object

    *Full details on working with Custom Fields here.

  • attachment_permissions object
  • 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.

  • default_image_url string

    The URL of the Contact's default image/profile photo, if any.

  • user object

    If the Contact is a Fleetio User, those details will be included here.

  • account_membership_id NullableId

    Possible values: >= 1

  • labor_time_entries object[]
  • id integer

    Possible values: >= 1

  • created_at date-time

    The date and time at which this record was created.

  • updated_at date-time

    The date and time at which this record was most recently updated.

  • account_id integer

    Possible values: >= 1

  • contact_id integer

    Possible values: >= 1

  • duration_in_seconds integer
  • ended_at date-time
  • laborable_id integer

    Possible values: >= 1

  • laborable_type string

    Possible values: [WorkOrderSubLineItem]

  • started_at date-time
  • data object
  • clock_in_latitude float
  • clock_in_longitude float
  • clock_out_latitude float
  • clock_out_longitude float
  • active boolean

    Indicates whether this Labor Time Entry is active.

  • subtotal float

    The pre-tax subtotal amount.

  • subtotal_cents integer

    The pre-tax subtotal amount in cents.

  • labor_cost float

    The cost of labor units worked.

  • parts_cost float

    The cost of parts.

  • parts_cost_cents integer

    The parts cost amount in cents.

  • labor_cost_cents integer

    The cost of labor units worked, in cents.

  • labor_time_entries object[]
  • id integer

    Possible values: >= 1

  • created_at date-time

    The date and time at which this record was created.

  • updated_at date-time

    The date and time at which this record was most recently updated.

  • account_id integer

    Possible values: >= 1

  • contact_id integer

    Possible values: >= 1

  • duration_in_seconds integer
  • ended_at date-time
  • laborable_id integer

    Possible values: >= 1

  • laborable_type string

    Possible values: [WorkOrderSubLineItem]

  • started_at date-time
  • data object
  • clock_in_latitude float
  • clock_in_longitude float
  • clock_out_latitude float
  • clock_out_longitude float
  • active boolean

    Indicates whether this Labor Time Entry is active.

  • meter_entry object

    A Meter Entry

  • id integer
  • created_at date-time
  • updated_at date-time
  • auto_voided_at date-time

    The date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in User's local time.

  • category string

    Possible values: [starting, ending, nightly, manual]

    A category to describe the function of this Meter Entry.

  • meter_type string

    Possible values: [secondary]

    Indicates whether or not this Meter is a secondary Meter.

  • meterable_id NullableId

    Possible values: >= 1

  • meterable_type string

    Possible values: [FuelEntry, Issue, PurchaseDetail, ServiceEntry, SubmittedInspectionItem, VehicleAssignment, WorkOrder]

    The type of the object with which this Meter Entry is associated.

  • value string

    The current value of the meter.

  • vehicle_id NullableId

    Possible values: >= 1

  • void boolean

    Default value: false

    Indicates whether or not this Meter Entry has been voided.

  • type string

    Possible values: [GpsMeterEntry]

  • date date

    The date on which this Meter Entry was recorded. Formatted according to ISO-8601.

  • starting_meter_entry object

    A Meter Entry

  • id integer
  • created_at date-time
  • updated_at date-time
  • auto_voided_at date-time

    The date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in User's local time.

  • category string

    Possible values: [starting, ending, nightly, manual]

    A category to describe the function of this Meter Entry.

  • meter_type string

    Possible values: [secondary]

    Indicates whether or not this Meter is a secondary Meter.

  • meterable_id NullableId

    Possible values: >= 1

  • meterable_type string

    Possible values: [FuelEntry, Issue, PurchaseDetail, ServiceEntry, SubmittedInspectionItem, VehicleAssignment, WorkOrder]

    The type of the object with which this Meter Entry is associated.

  • value string

    The current value of the meter.

  • vehicle_id NullableId

    Possible values: >= 1

  • void boolean

    Default value: false

    Indicates whether or not this Meter Entry has been voided.

  • type string

    Possible values: [GpsMeterEntry]

  • date date

    The date on which this Meter Entry was recorded. Formatted according to ISO-8601.

  • ending_meter_entry object

    A Meter Entry

  • id integer
  • created_at date-time
  • updated_at date-time
  • auto_voided_at date-time

    The date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in User's local time.

  • category string

    Possible values: [starting, ending, nightly, manual]

    A category to describe the function of this Meter Entry.

  • meter_type string

    Possible values: [secondary]

    Indicates whether or not this Meter is a secondary Meter.

  • meterable_id NullableId

    Possible values: >= 1

  • meterable_type string

    Possible values: [FuelEntry, Issue, PurchaseDetail, ServiceEntry, SubmittedInspectionItem, VehicleAssignment, WorkOrder]

    The type of the object with which this Meter Entry is associated.

  • value string

    The current value of the meter.

  • vehicle_id NullableId

    Possible values: >= 1

  • void boolean

    Default value: false

    Indicates whether or not this Meter Entry has been voided.

  • type string

    Possible values: [GpsMeterEntry]

  • date date

    The date on which this Meter Entry was recorded. Formatted according to ISO-8601.

  • secondary_meter_entry object

    A Meter Entry

  • id integer
  • created_at date-time
  • updated_at date-time
  • auto_voided_at date-time

    The date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in User's local time.

  • category string

    Possible values: [starting, ending, nightly, manual]

    A category to describe the function of this Meter Entry.

  • meter_type string

    Possible values: [secondary]

    Indicates whether or not this Meter is a secondary Meter.

  • meterable_id NullableId

    Possible values: >= 1

  • meterable_type string

    Possible values: [FuelEntry, Issue, PurchaseDetail, ServiceEntry, SubmittedInspectionItem, VehicleAssignment, WorkOrder]

    The type of the object with which this Meter Entry is associated.

  • value string

    The current value of the meter.

  • vehicle_id NullableId

    Possible values: >= 1

  • void boolean

    Default value: false

    Indicates whether or not this Meter Entry has been voided.

  • type string

    Possible values: [GpsMeterEntry]

  • date date

    The date on which this Meter Entry was recorded. Formatted according to ISO-8601.

  • starting_secondary_meter_entry object

    A Meter Entry

  • id integer
  • created_at date-time
  • updated_at date-time
  • auto_voided_at date-time

    The date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in User's local time.

  • category string

    Possible values: [starting, ending, nightly, manual]

    A category to describe the function of this Meter Entry.

  • meter_type string

    Possible values: [secondary]

    Indicates whether or not this Meter is a secondary Meter.

  • meterable_id NullableId

    Possible values: >= 1

  • meterable_type string

    Possible values: [FuelEntry, Issue, PurchaseDetail, ServiceEntry, SubmittedInspectionItem, VehicleAssignment, WorkOrder]

    The type of the object with which this Meter Entry is associated.

  • value string

    The current value of the meter.

  • vehicle_id NullableId

    Possible values: >= 1

  • void boolean

    Default value: false

    Indicates whether or not this Meter Entry has been voided.

  • type string

    Possible values: [GpsMeterEntry]

  • date date

    The date on which this Meter Entry was recorded. Formatted according to ISO-8601.

  • ending_secondary_meter_entry object

    A Meter Entry

  • id integer
  • created_at date-time
  • updated_at date-time
  • auto_voided_at date-time

    The date and time at which this Meter Entry was automatically voided. Formatted according to ISO-8601 in User's local time.

  • category string

    Possible values: [starting, ending, nightly, manual]

    A category to describe the function of this Meter Entry.

  • meter_type string

    Possible values: [secondary]

    Indicates whether or not this Meter is a secondary Meter.

  • meterable_id NullableId

    Possible values: >= 1

  • meterable_type string

    Possible values: [FuelEntry, Issue, PurchaseDetail, ServiceEntry, SubmittedInspectionItem, VehicleAssignment, WorkOrder]

    The type of the object with which this Meter Entry is associated.

  • value string

    The current value of the meter.

  • vehicle_id NullableId

    Possible values: >= 1

  • void boolean

    Default value: false

    Indicates whether or not this Meter Entry has been voided.

  • type string

    Possible values: [GpsMeterEntry]

  • date date

    The date on which this Meter Entry was recorded. Formatted according to ISO-8601.

  • attachment_permissions object
  • 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.

  • vmrs_repair_priority_class object

    The VMRS Repair Priority Class associated with this Work Order.

  • id integer

    The ID of the VMRS Repair Priority Class.

  • code string

    The code of the VMRS Repair Priority Class.

  • name string

    The name of the VMRS Repair Priority Class.

  • color string

    The color of the VMRS Repair Priority Class.

  • labels object[]
  • id integer

    Possible values: >= 1

  • name string
  • issues object[]

    Any Issues associated with this Work Order.

  • id integer

    The ID of the Issue.

  • name string

    The name of the Issue.

  • watchers_count integer

    The number of Users watching this Work Order.

  • is_watched boolean

    Indicates whether the current User is watching this Work Order.

  • discount_type DiscountType

    Possible values: [fixed, percentage]

    Default value: percentage

    The type of discount applied to this record.

  • discount_percentage float

    The discount percentage. This field should be present when discount_type is set to percentage.

  • discount float

    The discount amount.

  • parts_subtotal float

    The total cost of parts for this record.

  • labor_subtotal float

    The total cost of labor for this record.

  • subtotal float

    The pre-tax subtotal amount.

  • tax_1_type string

    Possible values: [fixed, percentage]

    Default value: percentage

    The type of tax to apply to this record.

  • tax_1_percentage float

    The primary tax percentage amount. This field should be present when tax_1_type is set to percentage.

  • tax_2_type string

    Possible values: [fixed, percentage]

    Default value: percentage

    The type of tax to apply to this record.

  • tax_2_percentage float

    The secondary tax percentage amount. This field should be present when tax_2_type is set to percentage. Note that this secondary tax must be configured in your Account Settings.

  • tax_1 float

    The primary tax amount.

  • tax_2 float

    The secondary tax amount. Note that this secondary tax must be configured in your Account Settings.

  • total_amount float

    The total amount.

  • labor_time_in_seconds integer

    The sum, in seconds, of the duration of all labor line items of a completed Work Order.

  • comments object[]

    A list of the comments made on this record.

  • id integer

    Possible values: >= 1

  • created_at date-time

    The date and time at which this record was created.

  • updated_at date-time

    The date and time at which this record was most recently updated.

  • commentable_type CommentableType

    Possible values: [Contact, FleetcorCard, FuelEntry, InventoryJournalEntry, Issue, Part, PurchaseOrder, ServiceEntry, ServiceReminder, SubmittedInspectionItem, Vehicle, VehicleAssignment, Vendor, WexCard, WorkOrder]

    The type of record that the Comment will be left on. Must be associated with a matching commentable_id.

  • commentable_id integer

    Possible values: >= 1

  • user_id integer

    Possible values: >= 1

  • title string deprecated

    The title of the Comment.

  • comment string

    The content of the Comment message body.

  • user_full_name string

    The full name of the User who created the Comment.

  • user_image_url string

    The image url for the User who created the Comment.

  • rich_content object
  • html_content string

    The comment message body rendered as HTML.

  • with_mentions boolean

    Indicates if the message body contains @mentions.

  • comments_count integer

    The number of comments made on this record.

  • images object[]

    A list of the images attached to this record.

  • id integer

    Possible values: >= 1

  • created_at date-time

    The date and time at which this record was created.

  • updated_at date-time

    The date and time at which this record was most recently updated.

  • imageable_id integer

    Possible values: >= 1

  • imageable_type ImageableType

    Possible values: [ExpenseEntry, WorkOrder, Equipment, IssueResolution, ServiceEntry, Vendor, ServiceProgram, Issue, Contact, Part, Vehicle, FuelEntry, SubmittedInspectionItem]

  • file_name string

    The name of the image file.

  • file_mime_type Image MIME Type

    Possible values: [image/jpeg, image/gif, image/jif, image/jfif, image/jfi, image/tiff, image/png, image/jpg, image/jpe, image/pdf, image/webp, image/tif, image/psd, image/raw, image/arw, image/cr2, image/nrw, image/k25, image/bmp, image/dip, image/ai, image/eps, image/heif, image/heic, image/ind, image/indd, image/indt, image/jp2, image/j2k, image/jpf, image/jpx, image/jpm, image/mj2, image/x-png]

  • file_size number

    The size of the image file in bytes.

  • file_url string

    The URL to access the image file.

  • full_url string

    The full URL to access the image file, including any necessary authentication or parameters.

  • images_count integer

    The number of images attached to this record.

  • documents object[]

    A list of the documents attached to this record.

  • id integer

    Possible values: >= 1

  • created_at date-time

    The date and time at which this record was created.

  • updated_at date-time

    The date and time at which this record was most recently updated.

  • name string

    The name of the document.

  • description string

    The description of the document.

  • documentable_id integer

    Possible values: >= 1

  • documentable_type DocumentableType

    Possible values: [ServiceEntry, FuelEntry, Issue, WorkOrder, ExpenseEntry]

  • file_name string

    The name of the file.

  • file_mime_type string

    The MIME type of the file.

  • file_size number

    The size of the file in bytes.

  • file_url string

    The URL to access the file.

  • full_file_url string

    The full URL to access the file, including any necessary authentication or parameters.

  • documents_count integer

    The number of documents attached to this record.

Loading...