Skip to main content

Create Work Order

POST 

https://secure.fleetio.com/api/v2/work_orders

Creates a new work order.

Request

Body

    issued_atdate-timerequired

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

    Example: 2023-03-14T13:46:27-06:00
    started_atdate-time

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

    Example: 2023-03-14T13:46:27-06:00
    completed_atdate-time

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

    Example: 2023-03-14T13:46:27-06:00
    work_order_status_idId (integer)required

    Possible values: >= 1

    invoice_numberstring

    The number of the Invoice associated with this Work Order.

    Possible values: <= 255 characters

    vendor_idNullableId (integer)nullable

    Possible values: >= 1

    vendor_namestring

    The name of the Vendor associated with this Work Order.

    Possible values: <= 255 characters

    vehicle_idId (integer)required

    Possible values: >= 1

    vehicle_namestring

    The name of the Vehicle associated with this Work Order.

    Possible values: <= 255 characters

    discount_typestring

    The type of discount applied to this Work Order.

    Possible values: [percentage, amount]

    discountfloat

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

    discount_percentagefloat

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

    parts_markup_percentagefloat

    The percentage of the parts markup applied to this Work Order. Used if parts_markup_type is set to percentage.

    Note: Parts markup fields are only writiable for Premium tier Fleetio Plan.

    parts_markup_typestring

    The type of parts markup to apply to this record.

    Note: Parts markup fields are only writiable for Premium tier Fleetio Plan.

    Possible values: [fixed, percentage]

    Default value: percentage
    parts_markupfloat

    The amount of the parts markup applied to this Work Order. Used if parts_markup_type is set to fixed.

    Note: Parts markup fields are only writiable for Premium tier Fleetio Plan.

    labor_markup_percentagefloat

    The percentage of the labor markup applied to this Work Order. Used if labor_markup_type is set to percentage.

    Note: Labor markup fields are only writiable for Premium tier Fleetio Plan.

    labor_markup_typestring

    The type of labor markup to apply to this record.

    Note: Labor markup fields are only writiable for Premium tier Fleetio Plan.

    Possible values: [fixed, percentage]

    Default value: percentage
    labor_markupfloat

    The amount of the labor markup applied to this Work Order. Used if labor_markup_type is set to fixed.

    Note: Labor markup fields are only writiable for Premium tier Fleetio Plan.

    tax_1_percentagefloat

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

    tax_1_typeTaxType (string)nullable

    The type of tax to apply to this record.

    Possible values: [fixed, percentage]

    Default value: percentage
    tax_1float

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

    tax_2_percentagefloat

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

    tax_2_typeTaxType (string)nullable

    The type of tax to apply to this record.

    Possible values: [fixed, percentage]

    Default value: percentage
    tax_2float

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

    issued_by_idNullableId (integer)nullable

    Possible values: >= 1

    contact_idNullableId (integer)nullable

    Possible values: >= 1

    label_listLabelListParameters (string)

    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.

    Possible values: <= 255 characters

    Example: High Priority
    purchase_order_numberstring

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

    descriptionstring

    A description of this Work Order.

    numberinteger

    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.

    valuefloat

    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.

    Example: 108043
    voidboolean

    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.

    valuefloat

    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.

    Example: 108043
    voidboolean

    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.

    valuefloat

    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.

    Example: 108043
    voidboolean

    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.

    valuefloat

    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.

    Example: 108043
    voidboolean

    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.

    valuefloat

    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.

    Example: 108043
    voidboolean

    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.

    valuefloat

    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.

    Example: 108043
    voidboolean

    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_fieldsobjectnullable

    *Full details on working with Custom Fields here.

    ending_meter_same_as_startboolean

    Use start meter for completion meter?

    vmrs_repair_priority_class_idNullableId (integer)nullable

    Possible values: >= 1

    scheduled_atdate-time

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

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

  • Array [
  • titlestring

    The title of the comment.

    commentstring

    The comment text.

  • ]
  • work_order_line_items_attributes object[]

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

  • Array [
  • idinteger

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

    item_typestring

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

    Possible values: [Issue, ServiceTask]

    item_namestring

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

    descriptionstring

    A description of this Work Order Line Item.

    item_idinteger

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

    labor_costfloat

    The cost of labor of this line item.

    parts_costfloat

    The cost of Parts of this line item.

    positioninteger

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

    subtotalfloat

    The subtotal of this line item.

    typestring

    Possible values: [WorkOrderServiceTaskLineItem, WorkOrderFreeTextLineItem]

    vmrs_reason_for_repair_idinteger

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

    vmrs_system_group_idinteger

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

    vmrs_system_idinteger

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

    vmrs_assembly_idinteger

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

    vmrs_component_idinteger

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

    issue_idsinteger[]

    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.

  • Array [
  • idinteger

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

    typestring

    Possible values: [WorkOrderPartLineItem, WorkOrderLaborLineItem]

    item_idinteger

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

    item_typestring

    Possible values: [Part, Contact]

    quantityfloat

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

    part_location_detail_idinteger

    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.

    positioninteger

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

    descriptionstring

    The description of this Work Order Line Item.

    inventory_set_idinteger

    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_idinteger

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

    vmrs_system_group_idinteger

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

    vmrs_system_idinteger

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

    vmrs_assembly_idinteger

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

    vmrs_component_idinteger

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

    labor_time_entries_attributes object[]
  • Array [
  • started_atdate-time

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

    ended_atdate-time

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

    contact_idNullableId (integer)nullable

    Possible values: >= 1

  • ]
  • ]
  • work_order_part_line_items_attributes object[]

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

  • Array [
  • idinteger

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

    typestring

    Possible values: [WorkOrderPartLineItem, WorkOrderLaborLineItem]

    item_idinteger

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

    item_typestring

    Possible values: [Part, Contact]

    quantityfloat

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

    part_location_detail_idinteger

    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.

    positioninteger

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

    descriptionstring

    The description of this Work Order Line Item.

    inventory_set_idinteger

    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_idinteger

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

    vmrs_system_group_idinteger

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

    vmrs_system_idinteger

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

    vmrs_assembly_idinteger

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

    vmrs_component_idinteger

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

    labor_time_entries_attributes object[]
  • Array [
  • started_atdate-time

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

    ended_atdate-time

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

    contact_idNullableId (integer)nullable

    Possible values: >= 1

  • ]
  • ]
  • work_order_labor_line_items_attributes object[]

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

  • Array [
  • idinteger

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

    typestring

    Possible values: [WorkOrderPartLineItem, WorkOrderLaborLineItem]

    item_idinteger

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

    item_typestring

    Possible values: [Part, Contact]

    quantityfloat

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

    part_location_detail_idinteger

    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.

    positioninteger

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

    descriptionstring

    The description of this Work Order Line Item.

    inventory_set_idinteger

    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_idinteger

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

    vmrs_system_group_idinteger

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

    vmrs_system_idinteger

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

    vmrs_assembly_idinteger

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

    vmrs_component_idinteger

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

    labor_time_entries_attributes object[]
  • Array [
  • started_atdate-time

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

    ended_atdate-time

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

    contact_idNullableId (integer)nullable

    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.

  • Array [
  • idinteger

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

    typestring

    Possible values: [WorkOrderPartLineItem, WorkOrderLaborLineItem]

    item_idinteger

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

    item_typestring

    Possible values: [Part, Contact]

    quantityfloat

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

    part_location_detail_idinteger

    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.

    positioninteger

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

    descriptionstring

    The description of this Work Order Line Item.

    inventory_set_idinteger

    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_idinteger

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

    vmrs_system_group_idinteger

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

    vmrs_system_idinteger

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

    vmrs_assembly_idinteger

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

    vmrs_component_idinteger

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

    labor_time_entries_attributes object[]
  • Array [
  • started_atdate-time

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

    ended_atdate-time

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

    contact_idNullableId (integer)nullable

    Possible values: >= 1

  • ]
  • ]
  • issue_idsNullableId (integer)[]

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

    Possible values: >= 1

    label_idsNullableId (integer)[]

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

    Possible values: >= 1

    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.

  • Array [
  • namestring

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

    Possible values: <= 255 characters

    file_urlstring

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

    Possible values: <= 255 characters

    file_mime_typestring

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

    Possible values: <= 255 characters

    file_namestring

    The name of the file.

    Possible values: <= 255 characters

    file_sizeinteger

    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.

  • Array [
  • namestring

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

    Possible values: <= 255 characters

    file_urlstring

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

    Possible values: <= 255 characters

    file_mime_typestring

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

    Possible values: <= 255 characters

    file_namestring

    The name of the image.

    Possible values: <= 255 characters

    file_sizeinteger

    The size of the image file in bytes.

  • ]

Responses

OK

Response Headers
    Schema
      idId (integer)required

      Possible values: >= 1

      created_atdate-time

      The date and time at which this record was created.

      Example: 2023-03-14T13:46:27-06:00
      updated_atdate-time

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

      Example: 2023-03-14T13:46:27-06:00
      numberstringrequired

      The unique number of this Work Order.

      completed_atdate-timenullablerequired

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

      Example: 2023-03-14T13:46:27-06:00
      descriptionstringnullablerequired

      A description of this Work Order.

      ending_meter_same_as_startbooleanrequired

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

      duration_in_secondsintegernullablerequired

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

      invoice_numberstringnullablerequired

      The number of the Invoice associated with this Work Order.

      created_by_idintegerrequired

      The id of the User who created this Work Order.

      statestringrequired

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

      Possible values: [active, completed]

      issued_atdate-timerequired

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

      Example: 2023-03-14T13:46:27-06:00
      issued_by_idNullableId (integer)nullablerequired

      Possible values: >= 1

      issued_by_namestringnullablerequired

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

      contact_idNullableId (integer)nullablerequired

      Possible values: >= 1

      contact_namestringnullablerequired

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

      purchase_order_numberstringnullablerequired

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

      started_atdate-timenullablerequired

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

      Example: 2023-03-14T13:46:27-06:00
      expected_completed_atdate-timenullable

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

      Example: 2023-03-14T13:46:27-06:00
      contact_image_urlstringnullable

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

      work_order_sub_line_items object[]required
    • Array [
    • anyOf
      idId (integer)required

      Possible values: >= 1

      created_atdate-time

      The date and time at which this record was created.

      Example: 2023-03-14T13:46:27-06:00
      updated_atdate-time

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

      Example: 2023-03-14T13:46:27-06:00
      descriptionstringnullable

      The description of the sub line item.

      item_idId (integer)

      Possible values: >= 1

      item_typestring

      Possible values: [Contact]

      work_order_line_item_idNullableId (integer)nullable

      Possible values: >= 1

      quantityfloat

      The quantity of this sub line item.

      part_location_detail_idNullableId (integer)nullable

      Possible values: >= 1

      positionintegernullable

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

      Possible values: >= 0

      item_namestring

      The name of this sub line item.

      unit_costfloat

      The unit cost of this sub line item.

      contact objectnullable

      A Contact

      idinteger
      created_atdate-time
      updated_atdate-time
      emailstringnullable

      The Contact's email address.

      namestringnullable

      The Contact's full name.

      first_namestringnullable

      The Contact's first name.

      middle_namestringnullable

      The Contact's middle name.

      last_namestringnullable

      The Contact's last name.

      images_countinteger

      The number of images associated with this Contact.

      Possible values: >= 0

      documents_countinteger

      The number of documents associated with this Contact.

      Possible values: >= 0

      comments_countinteger

      The number of comments associated with this Contact.

      Possible values: >= 0

      group_idintegernullable

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

      group_namestringnullable

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

      group_hierarchystringnullable

      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.

      Example: Group 1|Group 2|Group 3
      technicianbooleannullable

      Whether or not the Contact is a Technician.

      vehicle_operatorbooleannullable

      Whether or not the Contact is a Vehicle Operator.

      employeebooleannullable

      Whether or not the Contact is an Employee.

      birth_datedatenullable

      The Contact's birth date.

      Example: 2023-03-14
      street_addressstringnullable

      The Contact's street address.

      Example: 123 Main St
      street_address_line_2stringnullable

      The Contact's street address line 2.

      Example: Apt 1
      citystringnullable

      The Contact's city.

      regionstringnullable

      The Contact's region, state, or province.

      postal_codestringnullable

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

      countrystringnullable

      The Contact's country.

      employee_numberstringnullable

      The Contact's employee number.

      job_titlestringnullable

      The Contact's job title.

      Possible values: <= 255 characters

      license_classstringnullable

      The Contact's driver's license class.

      license_numberstringnullable

      The Contact's driver's license number.

      license_statestringnullable

      The locality which issued the Contact's license.

      license_expirationdatenullable

      The Contact's driver's license expiration date.

      Example: 2023-03-14
      home_phone_numberstringnullable

      The Contact's home phone number.

      mobile_phone_numberstringnullable

      The Contact's mobile phone number.

      work_phone_numberstringnullable

      The Contact's work phone number.

      other_phone_numberstringnullable

      Any other phone number for this Contact.

      start_datedatenullable

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

      leave_datedatenullable

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

      hourly_labor_ratefloatnullable

      The Contact's hourly rate.

      custom_fieldsobjectnullable

      *Full details on working with Custom Fields here.

      attachment_permissions objectnullable
      read_photosboolean

      Indicates whether the user has read permission for photos.

      manage_photosboolean

      Indicates whether the user has permission to manage (eg. upload, delete) photos.

      read_documentsboolean

      Indicates whether the user has read permission for documents.

      manage_documentsboolean

      Indicates whether the user has permission to manage (eg. upload, delete) documents.

      default_image_urlstringnullable

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

      userobjectnullable

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

      account_membership_idNullableId (integer)nullable

      Possible values: >= 1

      last_api_requestdate-timenullable

      The last date and time this Contact's associated User made an API request. Null if Contact is not assocated with a User.

      last_web_accessdate-timenullable

      The last date and time this Contact's associated User signed into the web application. Null if Contact is not assocated with a User.

      last_mobile_app_accessdate-timenullable

      The last date and time this Contact's associated User used the mobile app. Null if Contact is not assocated with a User.

      labor_time_entries object[]
    • Array [
    • idId (integer)required

      Possible values: >= 1

      created_atdate-time

      The date and time at which this record was created.

      Example: 2023-03-14T13:46:27-06:00
      updated_atdate-time

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

      Example: 2023-03-14T13:46:27-06:00
      account_idId (integer)

      Possible values: >= 1

      contact_idId (integer)

      Possible values: >= 1

      duration_in_secondsinteger
      ended_atdate-timenullable
      Example: 2023-03-14T13:46:27-06:00
      laborable_idId (integer)

      Possible values: >= 1

      laborable_typestring

      Possible values: [WorkOrderSubLineItem]

      started_atdate-time
      Example: 2023-03-14T13:46:27-06:00
      data object
      clock_in_latitudefloat
      clock_in_longitudefloat
      clock_out_latitudefloat
      clock_out_longitudefloat
      activeboolean

      Indicates whether this Labor Time Entry is active.

    • ]
    • ]
    • scheduled_atdate-timenullablerequired

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

      Example: 2023-03-14T13:46:27-06:00
      vehicle_idId (integer)required

      Possible values: >= 1

      vehicle_namestringrequired

      The name of the Vehicle associated with this Work Order.

      vendor_idNullableId (integer)nullablerequired

      Possible values: >= 1

      vendor_namestringnullablerequired

      The name of the Vendor associated with this Work Order.

      work_order_status_idId (integer)required

      Possible values: >= 1

      work_order_status_namestringrequired

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

      work_order_status_colorstringnullablerequired

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

      custom_fieldsobjectnullablerequired

      *Full details on working with Custom Fields here.

      work_order_line_items object[]required
    • Array [
    • idinteger

      Possible values: >= 1

      created_atdate-time

      The date and time at which this record was created.

      Example: 2023-03-14T13:46:27-06:00
      updated_atdate-time

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

      Example: 2023-03-14T13:46:27-06:00
      descriptionstringnullablerequired

      A description of this Work Order Line Item.

      titlestring

      The title of this Work Order Line Item.

      item_idintegerrequired

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

      item_typestringrequired

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

      Possible values: [Issue, ServiceTask]

      work_order_line_item_idintegernullablerequired
      item_namestringrequired

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

      positionintegernullablerequired

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

      issues object[]required

      Any Issues associated with this Work Order Line Item.

    • Array [
    • idinteger

      The ID of the Issue.

      namestring

      The name of the Issue.

    • ]
    • vmrs_reason_for_repair objectnullablerequired
      account_idinteger
      aliasstringnullable
      codestringnullable
      enabledboolean
      idinteger
      namestring
      repair_typestringnullable
      standardboolean
      standard_namestringnullable
      typestring
      vmrs_standard_reason_for_repairobjectnullable
      vmrs_system_group objectnullablerequired
      account_idnumbernullable
      assembly_codestringnullable
      assembly_namestringnullable
      code_typestring

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

      component_codestringnullable
      component_namestringnullable
      enabledboolean
      idinteger
      permissions objectnullable
      destroyboolean
      standardboolean
      system_codestringnullable
      system_groupstringnullable
      system_group_codestringnullable
      system_namestringnullable
      typestring
      vmrs_standard_system_assembly_componentobjectnullable
      vmrs_system objectnullablerequired
      account_idnumbernullable
      assembly_codestringnullable
      assembly_namestringnullable
      code_typestring

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

      component_codestringnullable
      component_namestringnullable
      enabledboolean
      idinteger
      permissions objectnullable
      destroyboolean
      standardboolean
      system_codestringnullable
      system_groupstringnullable
      system_group_codestringnullable
      system_namestringnullable
      typestring
      vmrs_standard_system_assembly_componentobjectnullable
      vmrs_assembly objectnullablerequired
      account_idnumbernullable
      assembly_codestringnullable
      assembly_namestringnullable
      code_typestring

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

      component_codestringnullable
      component_namestringnullable
      enabledboolean
      idinteger
      permissions objectnullable
      destroyboolean
      standardboolean
      system_codestringnullable
      system_groupstringnullable
      system_group_codestringnullable
      system_namestringnullable
      typestring
      vmrs_standard_system_assembly_componentobjectnullable
      vmrs_component objectnullablerequired
      account_idnumbernullable
      assembly_codestringnullable
      assembly_namestringnullable
      code_typestring

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

      component_codestringnullable
      component_namestringnullable
      enabledboolean
      idinteger
      permissions objectnullable
      destroyboolean
      standardboolean
      system_codestringnullable
      system_groupstringnullable
      system_group_codestringnullable
      system_namestringnullable
      typestring
      vmrs_standard_system_assembly_componentobjectnullable
      work_order_sub_line_items object[]required
    • Array [
    • anyOf
      idId (integer)required

      Possible values: >= 1

      created_atdate-time

      The date and time at which this record was created.

      Example: 2023-03-14T13:46:27-06:00
      updated_atdate-time

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

      Example: 2023-03-14T13:46:27-06:00
      descriptionstringnullable

      The description of the sub line item.

      item_idId (integer)

      Possible values: >= 1

      item_typestring

      Possible values: [Contact]

      work_order_line_item_idNullableId (integer)nullable

      Possible values: >= 1

      quantityfloat

      The quantity of this sub line item.

      part_location_detail_idNullableId (integer)nullable

      Possible values: >= 1

      positionintegernullable

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

      Possible values: >= 0

      item_namestring

      The name of this sub line item.

      unit_costfloat

      The unit cost of this sub line item.

      contact objectnullable

      A Contact

      idinteger
      created_atdate-time
      updated_atdate-time
      emailstringnullable

      The Contact's email address.

      namestringnullable

      The Contact's full name.

      first_namestringnullable

      The Contact's first name.

      middle_namestringnullable

      The Contact's middle name.

      last_namestringnullable

      The Contact's last name.

      images_countinteger

      The number of images associated with this Contact.

      Possible values: >= 0

      documents_countinteger

      The number of documents associated with this Contact.

      Possible values: >= 0

      comments_countinteger

      The number of comments associated with this Contact.

      Possible values: >= 0

      group_idintegernullable

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

      group_namestringnullable

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

      group_hierarchystringnullable

      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.

      Example: Group 1|Group 2|Group 3
      technicianbooleannullable

      Whether or not the Contact is a Technician.

      vehicle_operatorbooleannullable

      Whether or not the Contact is a Vehicle Operator.

      employeebooleannullable

      Whether or not the Contact is an Employee.

      birth_datedatenullable

      The Contact's birth date.

      Example: 2023-03-14
      street_addressstringnullable

      The Contact's street address.

      Example: 123 Main St
      street_address_line_2stringnullable

      The Contact's street address line 2.

      Example: Apt 1
      citystringnullable

      The Contact's city.

      regionstringnullable

      The Contact's region, state, or province.

      postal_codestringnullable

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

      countrystringnullable

      The Contact's country.

      employee_numberstringnullable

      The Contact's employee number.

      job_titlestringnullable

      The Contact's job title.

      Possible values: <= 255 characters

      license_classstringnullable

      The Contact's driver's license class.

      license_numberstringnullable

      The Contact's driver's license number.

      license_statestringnullable

      The locality which issued the Contact's license.

      license_expirationdatenullable

      The Contact's driver's license expiration date.

      Example: 2023-03-14
      home_phone_numberstringnullable

      The Contact's home phone number.

      mobile_phone_numberstringnullable

      The Contact's mobile phone number.

      work_phone_numberstringnullable

      The Contact's work phone number.

      other_phone_numberstringnullable

      Any other phone number for this Contact.

      start_datedatenullable

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

      leave_datedatenullable

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

      hourly_labor_ratefloatnullable

      The Contact's hourly rate.

      custom_fieldsobjectnullable

      *Full details on working with Custom Fields here.

      attachment_permissions objectnullable
      read_photosboolean

      Indicates whether the user has read permission for photos.

      manage_photosboolean

      Indicates whether the user has permission to manage (eg. upload, delete) photos.

      read_documentsboolean

      Indicates whether the user has read permission for documents.

      manage_documentsboolean

      Indicates whether the user has permission to manage (eg. upload, delete) documents.

      default_image_urlstringnullable

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

      userobjectnullable

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

      account_membership_idNullableId (integer)nullable

      Possible values: >= 1

      last_api_requestdate-timenullable

      The last date and time this Contact's associated User made an API request. Null if Contact is not assocated with a User.

      last_web_accessdate-timenullable

      The last date and time this Contact's associated User signed into the web application. Null if Contact is not assocated with a User.

      last_mobile_app_accessdate-timenullable

      The last date and time this Contact's associated User used the mobile app. Null if Contact is not assocated with a User.

      labor_time_entries object[]
    • Array [
    • idId (integer)required

      Possible values: >= 1

      created_atdate-time

      The date and time at which this record was created.

      Example: 2023-03-14T13:46:27-06:00
      updated_atdate-time

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

      Example: 2023-03-14T13:46:27-06:00
      account_idId (integer)

      Possible values: >= 1

      contact_idId (integer)

      Possible values: >= 1

      duration_in_secondsinteger
      ended_atdate-timenullable
      Example: 2023-03-14T13:46:27-06:00
      laborable_idId (integer)

      Possible values: >= 1

      laborable_typestring

      Possible values: [WorkOrderSubLineItem]

      started_atdate-time
      Example: 2023-03-14T13:46:27-06:00
      data object
      clock_in_latitudefloat
      clock_in_longitudefloat
      clock_out_latitudefloat
      clock_out_longitudefloat
      activeboolean

      Indicates whether this Labor Time Entry is active.

    • ]
    • ]
    • subtotalfloatnullable

      The pre-tax subtotal amount.

      Example: 1.23
      subtotal_centsintegernullable

      The pre-tax subtotal amount in cents.

      labor_costfloatnullable

      The cost of labor units worked.

      Example: 1.23
      parts_costfloatnullable

      The cost of parts.

      Example: 1.23
      parts_cost_centsintegernullable

      The parts cost amount in cents.

      labor_cost_centsintegernullable

      The cost of labor units worked, in cents.

    • ]
    • labor_time_entries object[]required
    • Array [
    • idId (integer)required

      Possible values: >= 1

      created_atdate-time

      The date and time at which this record was created.

      Example: 2023-03-14T13:46:27-06:00
      updated_atdate-time

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

      Example: 2023-03-14T13:46:27-06:00
      account_idId (integer)

      Possible values: >= 1

      contact_idId (integer)

      Possible values: >= 1

      duration_in_secondsinteger
      ended_atdate-timenullable
      Example: 2023-03-14T13:46:27-06:00
      laborable_idId (integer)

      Possible values: >= 1

      laborable_typestring

      Possible values: [WorkOrderSubLineItem]

      started_atdate-time
      Example: 2023-03-14T13:46:27-06:00
      data object
      clock_in_latitudefloat
      clock_in_longitudefloat
      clock_out_latitudefloat
      clock_out_longitudefloat
      activeboolean

      Indicates whether this Labor Time Entry is active.

    • ]
    • meter_entry objectnullable

      A Meter Entry

      idinteger
      created_atdate-time
      updated_atdate-time
      auto_voided_atdate-timenullable

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

      Example: 2023-03-14T13:46:27-06:00
      categorystringnullable

      A category to describe the function of this Meter Entry.

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

      meter_typestringnullable

      Indicates whether or not this Meter is a secondary Meter.

      Possible values: [secondary]

      meterable_idNullableId (integer)nullable

      Possible values: >= 1

      meterable_typestringnullable

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

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

      valuestring

      The current value of the meter.

      vehicle_idNullableId (integer)nullable

      Possible values: >= 1

      voidboolean

      Indicates whether or not this Meter Entry has been voided.

      Default value: false
      typestringnullable

      Possible values: [GpsMeterEntry]

      datedate

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

      Example: 2023-03-14
      starting_meter_entry objectnullable

      A Meter Entry

      idinteger
      created_atdate-time
      updated_atdate-time
      auto_voided_atdate-timenullable

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

      Example: 2023-03-14T13:46:27-06:00
      categorystringnullable

      A category to describe the function of this Meter Entry.

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

      meter_typestringnullable

      Indicates whether or not this Meter is a secondary Meter.

      Possible values: [secondary]

      meterable_idNullableId (integer)nullable

      Possible values: >= 1

      meterable_typestringnullable

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

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

      valuestring

      The current value of the meter.

      vehicle_idNullableId (integer)nullable

      Possible values: >= 1

      voidboolean

      Indicates whether or not this Meter Entry has been voided.

      Default value: false
      typestringnullable

      Possible values: [GpsMeterEntry]

      datedate

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

      Example: 2023-03-14
      ending_meter_entry objectnullable

      A Meter Entry

      idinteger
      created_atdate-time
      updated_atdate-time
      auto_voided_atdate-timenullable

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

      Example: 2023-03-14T13:46:27-06:00
      categorystringnullable

      A category to describe the function of this Meter Entry.

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

      meter_typestringnullable

      Indicates whether or not this Meter is a secondary Meter.

      Possible values: [secondary]

      meterable_idNullableId (integer)nullable

      Possible values: >= 1

      meterable_typestringnullable

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

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

      valuestring

      The current value of the meter.

      vehicle_idNullableId (integer)nullable

      Possible values: >= 1

      voidboolean

      Indicates whether or not this Meter Entry has been voided.

      Default value: false
      typestringnullable

      Possible values: [GpsMeterEntry]

      datedate

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

      Example: 2023-03-14
      secondary_meter_entry objectnullable

      A Meter Entry

      idinteger
      created_atdate-time
      updated_atdate-time
      auto_voided_atdate-timenullable

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

      Example: 2023-03-14T13:46:27-06:00
      categorystringnullable

      A category to describe the function of this Meter Entry.

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

      meter_typestringnullable

      Indicates whether or not this Meter is a secondary Meter.

      Possible values: [secondary]

      meterable_idNullableId (integer)nullable

      Possible values: >= 1

      meterable_typestringnullable

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

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

      valuestring

      The current value of the meter.

      vehicle_idNullableId (integer)nullable

      Possible values: >= 1

      voidboolean

      Indicates whether or not this Meter Entry has been voided.

      Default value: false
      typestringnullable

      Possible values: [GpsMeterEntry]

      datedate

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

      Example: 2023-03-14
      starting_secondary_meter_entry objectnullable

      A Meter Entry

      idinteger
      created_atdate-time
      updated_atdate-time
      auto_voided_atdate-timenullable

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

      Example: 2023-03-14T13:46:27-06:00
      categorystringnullable

      A category to describe the function of this Meter Entry.

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

      meter_typestringnullable

      Indicates whether or not this Meter is a secondary Meter.

      Possible values: [secondary]

      meterable_idNullableId (integer)nullable

      Possible values: >= 1

      meterable_typestringnullable

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

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

      valuestring

      The current value of the meter.

      vehicle_idNullableId (integer)nullable

      Possible values: >= 1

      voidboolean

      Indicates whether or not this Meter Entry has been voided.

      Default value: false
      typestringnullable

      Possible values: [GpsMeterEntry]

      datedate

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

      Example: 2023-03-14
      ending_secondary_meter_entry objectnullable

      A Meter Entry

      idinteger
      created_atdate-time
      updated_atdate-time
      auto_voided_atdate-timenullable

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

      Example: 2023-03-14T13:46:27-06:00
      categorystringnullable

      A category to describe the function of this Meter Entry.

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

      meter_typestringnullable

      Indicates whether or not this Meter is a secondary Meter.

      Possible values: [secondary]

      meterable_idNullableId (integer)nullable

      Possible values: >= 1

      meterable_typestringnullable

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

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

      valuestring

      The current value of the meter.

      vehicle_idNullableId (integer)nullable

      Possible values: >= 1

      voidboolean

      Indicates whether or not this Meter Entry has been voided.

      Default value: false
      typestringnullable

      Possible values: [GpsMeterEntry]

      datedate

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

      Example: 2023-03-14
      attachment_permissions objectnullable
      read_photosboolean

      Indicates whether the user has read permission for photos.

      manage_photosboolean

      Indicates whether the user has permission to manage (eg. upload, delete) photos.

      read_documentsboolean

      Indicates whether the user has read permission for documents.

      manage_documentsboolean

      Indicates whether the user has permission to manage (eg. upload, delete) documents.

      vmrs_repair_priority_class objectnullablerequired

      The VMRS Repair Priority Class associated with this Work Order.

      idinteger

      The ID of the VMRS Repair Priority Class.

      codestring

      The code of the VMRS Repair Priority Class.

      namestring

      The name of the VMRS Repair Priority Class.

      colorstring

      The color of the VMRS Repair Priority Class.

      labels object[]required
    • Array [
    • idId (integer)

      Possible values: >= 1

      namestring
    • ]
    • issues object[]required

      Any Issues associated with this Work Order.

    • Array [
    • idinteger

      The ID of the Issue.

      namestring

      The name of the Issue.

    • ]
    • watchers_countinteger

      The number of Users watching this Work Order.

      is_watchedboolean

      Indicates whether the current User is watching this Work Order.

      discount_typeDiscountType (string)nullablerequired

      The type of discount applied to this record.

      Possible values: [fixed, percentage]

      Default value: percentage
      discount_percentagefloatnullablerequired

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

      Example: 1.23
      discountfloatnullablerequired

      The discount amount.

      Example: 1.23
      parts_subtotalfloatnullablerequired

      The total cost of parts for this record.

      Example: 1.23
      labor_subtotalfloatnullablerequired

      The total cost of labor for this record.

      Example: 1.23
      subtotalfloatnullablerequired

      The pre-tax subtotal amount.

      Example: 1.23
      tax_1_typeTaxType (string)nullablerequired

      The type of tax to apply to this record.

      Possible values: [fixed, percentage]

      Default value: percentage
      tax_1_percentagefloatnullablerequired

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

      Example: 1.23
      tax_2_typeTaxType (string)nullablerequired

      The type of tax to apply to this record.

      Possible values: [fixed, percentage]

      Default value: percentage
      tax_2_percentagefloatnullablerequired

      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.

      Example: 1.23
      tax_1floatnullablerequired

      The primary tax amount.

      Example: 1.23
      tax_2floatnullablerequired

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

      Example: 1.23
      parts_markup_typePartMarkupType (string)

      The type of parts markup applied to the record Note that this is a readonly value that will default to percentage for non-premium plans

      Possible values: [fixed, percentage]

      parts_markupfloat

      The parts markup amount. Note that this is a readonly value that will default to 0.0 for non-premium plans

      Example: 1.23
      parts_markup_percentagefloat

      The parts markup percentage amount. This field should be present when parts_markup_type is set to percentage.

      Note that this is a readonly value that will default to 0.0 for non-premium plans

      Example: 1.23
      labor_markup_typeLaborMarkupType (string)

      The type of labor markup applied to the record Note that this is a readonly value that will default to percentage for non-premium plans

      Possible values: [fixed, percentage]

      labor_markupfloat

      The labor markup amount. Note that this is a readonly value that will default to 0.0 for non-premium plans

      Example: 1.23
      labor_markup_percentagefloat

      The labor markup percentage amount. This field should be present when labor_markup_type is set to percentage.

      Note that this is a readonly value that will default to 0.0 for non-premium plans

      Example: 1.23
      total_amountfloatnullablerequired

      The total amount.

      Example: 1.23
      labor_time_in_secondsintegernullable

      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.

    • Array [
    • idId (integer)required

      Possible values: >= 1

      created_atdate-time

      The date and time at which this record was created.

      Example: 2023-03-14T13:46:27-06:00
      updated_atdate-time

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

      Example: 2023-03-14T13:46:27-06:00
      commentable_typeCommentableType (string)required

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

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

      commentable_idId (integer)required

      Possible values: >= 1

      user_idId (integer)required

      Possible values: >= 1

      titlestringdeprecated

      The title of the Comment.

      commentstringrequired

      The content of the Comment message body.

      user_full_namestringrequired

      The full name of the User who created the Comment.

      user_image_urlstringnullablerequired

      The image url for the User who created the Comment.

      rich_contentobjectnullablerequired
      html_contentstringnullablerequired

      The comment message body rendered as HTML.

      with_mentionsbooleanrequired

      Indicates if the message body contains @mentions.

    • ]
    • comments_countinteger

      The number of comments made on this record.

      Possible values: >= 0

      images object[]

      A list of the images attached to this record.

    • Array [
    • idId (integer)required

      Possible values: >= 1

      created_atdate-time

      The date and time at which this record was created.

      Example: 2023-03-14T13:46:27-06:00
      updated_atdate-time

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

      Example: 2023-03-14T13:46:27-06:00
      imageable_idId (integer)

      Possible values: >= 1

      imageable_typeImageableType (string)

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

      file_namestring

      The name of the image file.

      file_mime_typeImage MIME Type (string)

      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_sizenumber

      The size of the image file in bytes.

      file_urlstring

      The URL to access the image file.

      full_urlstring

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

    • ]
    • images_countinteger

      The number of images attached to this record.

      Possible values: >= 0

      documents object[]

      A list of the documents attached to this record.

    • Array [
    • idId (integer)required

      Possible values: >= 1

      created_atdate-time

      The date and time at which this record was created.

      Example: 2023-03-14T13:46:27-06:00
      updated_atdate-time

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

      Example: 2023-03-14T13:46:27-06:00
      namestringrequired

      The name of the document.

      descriptionstringrequired

      The description of the document.

      documentable_idId (integer)required

      Possible values: >= 1

      documentable_typeDocumentableType (string)required

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

      file_namestringrequired

      The name of the file.

      file_mime_typestringrequired

      The MIME type of the file.

      file_sizenumberrequired

      The size of the file in bytes.

      file_urlstringrequired

      The URL to access the file.

      full_file_urlstringrequired

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

    • ]
    • documents_countinteger

      The number of documents attached to this record.

      Possible values: >= 0

    Authorization: Authorization

    name: Authorizationtype: apiKeyin: headerdescription: Prefix the value with "Token", for example: "Token 76cbe06c49a64".
    You can generate a new API key [here](https://secure.fleetio.com/api_keys).
    name: Account-Tokentype: apiKeyin: headerdescription: You can find your Account-Token [here](https://secure.fleetio.com/api_keys)
    curl -L 'https://secure.fleetio.com/api/v2/work_orders' \
    -H 'Content-Type: application/json' \
    -H 'Accept: application/json' \
    -H 'Authorization: Token <Authorization>' \
    -H 'Account-Token: <Authorization>' \
    -d '{
    "issued_at": "2023-03-14T13:46:27-06:00",
    "started_at": "2023-03-14T13:46:27-06:00",
    "completed_at": "2023-03-14T13:46:27-06:00",
    "work_order_status_id": 0,
    "invoice_number": "string",
    "vendor_id": 0,
    "vendor_name": "string",
    "vehicle_id": 0,
    "vehicle_name": "string",
    "discount_type": "percentage",
    "discount": 0,
    "discount_percentage": 0,
    "parts_markup_percentage": 0,
    "parts_markup_type": "percentage",
    "parts_markup": 0,
    "labor_markup_percentage": 0,
    "labor_markup_type": "percentage",
    "labor_markup": 0,
    "tax_1_percentage": 0,
    "tax_1_type": "percentage",
    "tax_1": 0,
    "tax_2_percentage": 0,
    "tax_2_type": "percentage",
    "tax_2": 0,
    "issued_by_id": 0,
    "contact_id": 0,
    "label_list": "High Priority",
    "purchase_order_number": "string",
    "description": "string",
    "number": 0,
    "meter_entry_attributes": {
    "value": "108043",
    "void": true
    },
    "secondary_meter_entry_attributes": {
    "value": "108043",
    "void": true
    },
    "starting_meter_entry_attributes": {
    "value": "108043",
    "void": true
    },
    "ending_meter_entry_attributes": {
    "value": "108043",
    "void": true
    },
    "starting_secondary_meter_entry_attributes": {
    "value": "108043",
    "void": true
    },
    "ending_secondary_meter_entry_attributes": {
    "value": "108043",
    "void": true
    },
    "custom_fields": {},
    "ending_meter_same_as_start": true,
    "vmrs_repair_priority_class_id": 0,
    "scheduled_at": "2024-07-29T15:51:28.071Z",
    "expected_completed_at": "2024-07-29T15:51:28.071Z",
    "comments_attributes": [
    {
    "title": "string",
    "comment": "string"
    }
    ],
    "work_order_line_items_attributes": [
    {
    "id": 0,
    "item_type": "Issue",
    "item_name": "string",
    "description": "string",
    "item_id": 0,
    "labor_cost": 0,
    "parts_cost": 0,
    "position": 0,
    "subtotal": 0,
    "type": "WorkOrderServiceTaskLineItem",
    "vmrs_reason_for_repair_id": 0,
    "vmrs_system_group_id": 0,
    "vmrs_system_id": 0,
    "vmrs_assembly_id": 0,
    "vmrs_component_id": 0,
    "issue_ids": [
    0
    ],
    "work_order_sub_line_items_attributes": [
    {
    "id": 0,
    "type": "WorkOrderPartLineItem",
    "item_id": 0,
    "item_type": "Part",
    "quantity": 0,
    "part_location_detail_id": 0,
    "position": 0,
    "description": "string",
    "inventory_set_id": 0,
    "vmrs_reason_for_repair_id": 0,
    "vmrs_system_group_id": 0,
    "vmrs_system_id": 0,
    "vmrs_assembly_id": 0,
    "vmrs_component_id": 0,
    "labor_time_entries_attributes": [
    {
    "started_at": "2024-07-29T15:51:28.071Z",
    "ended_at": "2024-07-29T15:51:28.071Z",
    "contact_id": 0
    }
    ]
    }
    ],
    "work_order_part_line_items_attributes": [
    {
    "id": 0,
    "type": "WorkOrderPartLineItem",
    "item_id": 0,
    "item_type": "Part",
    "quantity": 0,
    "part_location_detail_id": 0,
    "position": 0,
    "description": "string",
    "inventory_set_id": 0,
    "vmrs_reason_for_repair_id": 0,
    "vmrs_system_group_id": 0,
    "vmrs_system_id": 0,
    "vmrs_assembly_id": 0,
    "vmrs_component_id": 0,
    "labor_time_entries_attributes": [
    {
    "started_at": "2024-07-29T15:51:28.071Z",
    "ended_at": "2024-07-29T15:51:28.071Z",
    "contact_id": 0
    }
    ]
    }
    ],
    "work_order_labor_line_items_attributes": [
    {
    "id": 0,
    "type": "WorkOrderPartLineItem",
    "item_id": 0,
    "item_type": "Part",
    "quantity": 0,
    "part_location_detail_id": 0,
    "position": 0,
    "description": "string",
    "inventory_set_id": 0,
    "vmrs_reason_for_repair_id": 0,
    "vmrs_system_group_id": 0,
    "vmrs_system_id": 0,
    "vmrs_assembly_id": 0,
    "vmrs_component_id": 0,
    "labor_time_entries_attributes": [
    {
    "started_at": "2024-07-29T15:51:28.071Z",
    "ended_at": "2024-07-29T15:51:28.071Z",
    "contact_id": 0
    }
    ]
    }
    ]
    }
    ],
    "work_order_sub_line_items_attributes": [
    {
    "id": 0,
    "type": "WorkOrderPartLineItem",
    "item_id": 0,
    "item_type": "Part",
    "quantity": 0,
    "part_location_detail_id": 0,
    "position": 0,
    "description": "string",
    "inventory_set_id": 0,
    "vmrs_reason_for_repair_id": 0,
    "vmrs_system_group_id": 0,
    "vmrs_system_id": 0,
    "vmrs_assembly_id": 0,
    "vmrs_component_id": 0,
    "labor_time_entries_attributes": [
    {
    "started_at": "2024-07-29T15:51:28.071Z",
    "ended_at": "2024-07-29T15:51:28.071Z",
    "contact_id": 0
    }
    ]
    }
    ],
    "issue_ids": [
    0
    ],
    "label_ids": [
    0
    ],
    "documents_attributes": [
    {
    "name": "string",
    "file_url": "string",
    "file_mime_type": "string",
    "file_name": "string",
    "file_size": 0
    }
    ],
    "images_attributes": [
    {
    "name": "string",
    "file_url": "string",
    "file_mime_type": "string",
    "file_name": "string",
    "file_size": 0
    }
    ]
    }'
    Request Collapse all
    Base URL
    https://secure.fleetio.com/api
    Auth
    Body
    {
      "issued_at": "2023-03-14T13:46:27-06:00",
      "started_at": "2023-03-14T13:46:27-06:00",
      "completed_at": "2023-03-14T13:46:27-06:00",
      "work_order_status_id": 0,
      "invoice_number": "string",
      "vendor_id": 0,
      "vendor_name": "string",
      "vehicle_id": 0,
      "vehicle_name": "string",
      "discount_type": "percentage",
      "discount": 0,
      "discount_percentage": 0,
      "parts_markup_percentage": 0,
      "parts_markup_type": "percentage",
      "parts_markup": 0,
      "labor_markup_percentage": 0,
      "labor_markup_type": "percentage",
      "labor_markup": 0,
      "tax_1_percentage": 0,
      "tax_1_type": "percentage",
      "tax_1": 0,
      "tax_2_percentage": 0,
      "tax_2_type": "percentage",
      "tax_2": 0,
      "issued_by_id": 0,
      "contact_id": 0,
      "label_list": "High Priority",
      "purchase_order_number": "string",
      "description": "string",
      "number": 0,
      "meter_entry_attributes": {
        "value": "108043",
        "void": true
      },
      "secondary_meter_entry_attributes": {
        "value": "108043",
        "void": true
      },
      "starting_meter_entry_attributes": {
        "value": "108043",
        "void": true
      },
      "ending_meter_entry_attributes": {
        "value": "108043",
        "void": true
      },
      "starting_secondary_meter_entry_attributes": {
        "value": "108043",
        "void": true
      },
      "ending_secondary_meter_entry_attributes": {
        "value": "108043",
        "void": true
      },
      "custom_fields": {},
      "ending_meter_same_as_start": true,
      "vmrs_repair_priority_class_id": 0,
      "scheduled_at": "2024-07-29T15:51:28.071Z",
      "expected_completed_at": "2024-07-29T15:51:28.071Z",
      "comments_attributes": [
        {
          "title": "string",
          "comment": "string"
        }
      ],
      "work_order_line_items_attributes": [
        {
          "id": 0,
          "item_type": "Issue",
          "item_name": "string",
          "description": "string",
          "item_id": 0,
          "labor_cost": 0,
          "parts_cost": 0,
          "position": 0,
          "subtotal": 0,
          "type": "WorkOrderServiceTaskLineItem",
          "vmrs_reason_for_repair_id": 0,
          "vmrs_system_group_id": 0,
          "vmrs_system_id": 0,
          "vmrs_assembly_id": 0,
          "vmrs_component_id": 0,
          "issue_ids": [
            0
          ],
          "work_order_sub_line_items_attributes": [
            {
              "id": 0,
              "type": "WorkOrderPartLineItem",
              "item_id": 0,
              "item_type": "Part",
              "quantity": 0,
              "part_location_detail_id": 0,
              "position": 0,
              "description": "string",
              "inventory_set_id": 0,
              "vmrs_reason_for_repair_id": 0,
              "vmrs_system_group_id": 0,
              "vmrs_system_id": 0,
              "vmrs_assembly_id": 0,
              "vmrs_component_id": 0,
              "labor_time_entries_attributes": [
                {
                  "started_at": "2024-07-29T15:51:28.071Z",
                  "ended_at": "2024-07-29T15:51:28.071Z",
                  "contact_id": 0
                }
              ]
            }
          ],
          "work_order_part_line_items_attributes": [
            {
              "id": 0,
              "type": "WorkOrderPartLineItem",
              "item_id": 0,
              "item_type": "Part",
              "quantity": 0,
              "part_location_detail_id": 0,
              "position": 0,
              "description": "string",
              "inventory_set_id": 0,
              "vmrs_reason_for_repair_id": 0,
              "vmrs_system_group_id": 0,
              "vmrs_system_id": 0,
              "vmrs_assembly_id": 0,
              "vmrs_component_id": 0,
              "labor_time_entries_attributes": [
                {
                  "started_at": "2024-07-29T15:51:28.071Z",
                  "ended_at": "2024-07-29T15:51:28.071Z",
                  "contact_id": 0
                }
              ]
            }
          ],
          "work_order_labor_line_items_attributes": [
            {
              "id": 0,
              "type": "WorkOrderPartLineItem",
              "item_id": 0,
              "item_type": "Part",
              "quantity": 0,
              "part_location_detail_id": 0,
              "position": 0,
              "description": "string",
              "inventory_set_id": 0,
              "vmrs_reason_for_repair_id": 0,
              "vmrs_system_group_id": 0,
              "vmrs_system_id": 0,
              "vmrs_assembly_id": 0,
              "vmrs_component_id": 0,
              "labor_time_entries_attributes": [
                {
                  "started_at": "2024-07-29T15:51:28.071Z",
                  "ended_at": "2024-07-29T15:51:28.071Z",
                  "contact_id": 0
                }
              ]
            }
          ]
        }
      ],
      "work_order_sub_line_items_attributes": [
        {
          "id": 0,
          "type": "WorkOrderPartLineItem",
          "item_id": 0,
          "item_type": "Part",
          "quantity": 0,
          "part_location_detail_id": 0,
          "position": 0,
          "description": "string",
          "inventory_set_id": 0,
          "vmrs_reason_for_repair_id": 0,
          "vmrs_system_group_id": 0,
          "vmrs_system_id": 0,
          "vmrs_assembly_id": 0,
          "vmrs_component_id": 0,
          "labor_time_entries_attributes": [
            {
              "started_at": "2024-07-29T15:51:28.071Z",
              "ended_at": "2024-07-29T15:51:28.071Z",
              "contact_id": 0
            }
          ]
        }
      ],
      "issue_ids": [
        0
      ],
      "label_ids": [
        0
      ],
      "documents_attributes": [
        {
          "name": "string",
          "file_url": "string",
          "file_mime_type": "string",
          "file_name": "string",
          "file_size": 0
        }
      ],
      "images_attributes": [
        {
          "name": "string",
          "file_url": "string",
          "file_mime_type": "string",
          "file_name": "string",
          "file_size": 0
        }
      ]
    }
    
    ResponseClear

    Click the Send API Request button above and see the response here!