API Reference

Jobs API

Create and manage service jobs

The Jobs API allows you to create, update, and manage service jobs. Jobs are the core entity in ManoPlan, representing individual service appointments assigned to technicians.

Endpoints

List Jobs

GET
/api/jobs

Retrieve all jobs for your company

Get Job

GET
/api/jobs/:id

Retrieve a specific job by ID

Create Job

POST
/api/jobs

Create a new service job

Update Job

PATCH
/api/jobs/:id

Update an existing job

Delete Job

DELETE
/api/jobs/:id

Delete a job

Update Status

PATCH
/api/jobs/:id/status

Update job status

Job Status

Jobs progress through these status values

newNew - Job created but not scheduled
plannedPlanned - Date and time scheduled
confirmedConfirmed - Customer notified
en_routeEn Route - Technician traveling
in_progressIn Progress - Work started
completedCompleted - Work finished
billedBilled - Invoice created

Job Fields

Available fields when creating or updating jobs

customerIdCustomer ID (required)
categoryJob category (e.g. Heating, Electrical)
descriptionJob description
priorityPriority level (low, normal, high, urgent)
estimatedMinutesEstimated duration in minutes
scheduledDateScheduled date and time (ISO 8601)
assignedUserIdAssigned technician ID

Best Practices

  • Always include a descriptive job description
  • Set realistic time estimates for better scheduling
  • Use the status endpoint to track job progress
  • Include material sets for complete job documentation

More API Documentation

Customers API

Manage customer data

Routes API

Optimize and manage routes

Test Jobs API

Create and manage jobs via the API