List jobs

List jobs, optionally by status, customer or date.

GET https://cotlet.dev/api/v1/simpro/jobs

read

Returns jobs with number, customer, site, status and stage, newest first. Pages until the list ends. Stage and status are separate fields in Simpro, and the status filter uses your own status names.

Parameters

Parameters: list_jobs
NameTypeDescription
status string string A job status name from your build.
customer_id integer integer Only jobs for this customer.
date_from string string ISO date; only jobs created on or after it.
page integer integer Page number, starting at 1.

Request

cURL
curl https://cotlet.dev/api/v1/simpro/jobs \
  -H "Authorization: Bearer $COTLET_API_KEY"
Python
result = client.call("simpro", "list_jobs")
Node.js
const result = await cotlet.call('simpro', 'list_jobs');
CLI
cotlet call simpro list_jobs

Example response

JSON

{
  "jobs": [
    {
      "job_id": 20871,
      "customer": "Harbour Dental",
      "site": "12 Pier Rd",
      "status": "Pending",
      "stage": "Pending"
    }
  ],
  "page": 1,
  "has_more": false
}

Sign in once. Your agent does the rest.

Sign up and add the apps you need. Free 7-day trial with 2,000 credits, no card needed.