Work Orders
Mobile

Get next job for a contact.

Get the next scheduled job for a contact, given the currently active work order.

get/services/next_job

Request

  • Base URL: https://api.floorworks.co.uk/api/v1
  • URL: https://api.floorworks.co.uk/api/v1/services/next_job
  • Auth: OAuth 2 (password, token URL https://api.floorworks.co.uk/api/v1/auth)

Query parameters

contact_idstring required

Contact UUID.

idstring

UUID of the currently active work order to exclude.

Response

Next job, if any.

contact_idstring uuid

ID of the contact that is associated with this document.

manager_contact_idstring uuid

Manager Id.

department_idnumber

Department Id.

property_idstring uuid

Property Id.

workflow_status'PENDING' | 'APPOINTED' | 'IN PROGRESS' | 'ON HOLD' | 'COMPLETED' | 'CANCELLED'

Workflow Status

vendor_status'N/A' | 'IMPORTED' | 'EXPORTED'

Vendor Status

financial_status'PENDING' | 'APPROVED' | 'INVOICED' | 'VOID' | 'INVOICED PARTIALLY' | 'CONTRACT' | 'PPM_CONTRACT'

Financial Status

quote_idstring uuid

Quote Id.

survey_idstring uuid

Survey Id.

time_completedinteger

Booking time.

time_bookinginteger

Booking time.

time_dueinteger

Due date.

total_discountnumber double

Total Discount

total_costnumber double

Total Cost

total_pricenumber double

Total price ex. VAT

service_refstring

Auto generated reference of the document.

reference_externalstring

Vendor invoice ID for external reference. Use this field to filter and retrieve all the orders that have this ID. Used for filtering.

idnumber

ID.

uuidstring uuid

UUID.

time_modifiedstring YYYY-MM-DD

Last modification date

time_createdstring YYYY-MM-DD

Creation date

Example response

{
  "time_completed": 1755388800,
  "time_booking": 1755388800,
  "time_due": 1755388800,
  "id": 12345,
  "time_modified": "2025-08-18",
  "time_created": "2025-08-17"
}

Changes

No recorded changes to this operation across all 1 revision of this API.