Skip to main content

Create Work Order

Creates a new work order.

Request Body

  • issued_at date-time required

    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 required

    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 required

    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.

Responses

OK

Response Headers


    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

      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.

    • 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
      oneOf

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

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

    • subtotal float

      The pre-tax subtotal amount.

    • subtotal_cents integer

      The pre-tax subtotal amount in cents.

    • 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[]
      oneOf

    • 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

      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.

    • 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
      oneOf

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

    • 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
      oneOf

    • 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

      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.

    • 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

      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.

    • 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

      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.

    • 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

      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.

    • 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

      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.

    • 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

      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.

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

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

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