[Cotlet](https://cotlet.dev/index.md) · [Integrations](https://cotlet.dev/integrations.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Use cases](https://cotlet.dev/use-cases.md) · [Security](https://cotlet.dev/security.md) · [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md) · [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [Contact](https://cotlet.dev/contact.md) · [Pricing](https://cotlet.dev/pricing.md) · [Sign up](https://cotlet.dev/signup)

# List jobs

> List jobs filtered by status, location, customer, technician or due date. Inputs, cURL, Python and Node.js examples and an example response.

Source: https://cotlet.dev/docs/api/servicetrade/list_jobs

Docs sections: [Get started](https://cotlet.dev/docs.md) · [REST API](https://cotlet.dev/docs/api.md) · [MCP](https://cotlet.dev/docs/mcp.md) · [SDKs & CLI](https://cotlet.dev/docs/sdks.md) · [Integrations](https://cotlet.dev/docs/integrations.md)

List jobs filtered by status, location, customer, technician or due date.

ServiceTrade API: https://cotlet.dev/docs/api/servicetrade.md

`GET https://cotlet.dev/api/v1/servicetrade/jobs`

Access: read.

Returns the job number, name, type, status, location, customer and due date, and the number of services still open. The agent sorts by due date itself. A job with status new is shown by ServiceTrade as Unscheduled. What you see follows your role in ServiceTrade.

## Parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `status` | string | no | One or more of new (shown as Unscheduled), scheduled, canceled, bidding, completed, pending_invoice, sending_invoice, invoiced, closed, comma-separated. |
| `location_id` | integer | no | Only jobs at this location, from list_locations. |
| `customer_id` | integer | no | Only jobs for this customer company. |
| `technician_id` | integer | no | Only jobs with an appointment for this technician, from list_technicians. |
| `due_by_before` | string | no | ISO 8601 date or date-time; only jobs due on or before it. |
| `cursor` | string | no | Next page cursor from the previous call. |

## Request

**cURL**

```bash
curl https://cotlet.dev/api/v1/servicetrade/jobs \
  -H "Authorization: Bearer $COTLET_API_KEY"
```

**Python**

```python
result = client.call("servicetrade", "list_jobs")
```

**Node.js**

```js
const result = await cotlet.call('servicetrade', 'list_jobs');
```

**CLI**

```bash
cotlet call servicetrade list_jobs
```

## Example response

```json
{
  "jobs": [
    {
      "id": 48213,
      "number": 1042,
      "name": "Fire pump test",
      "type": "planned_maintenance",
      "status": "new",
      "display_status": "Unscheduled",
      "location": {
        "id": 5120,
        "name": "Harbor Point Mall"
      },
      "customer": {
        "id": 2211,
        "name": "Harbor Point Properties"
      },
      "due_by": "2026-10-30",
      "open_services": 2
    }
  ],
  "next_cursor": null
}
```

Next: [Get a job](https://cotlet.dev/docs/api/servicetrade/get_job.md)

---

Give your AI agents your signed-in browser.

**Product:** [Integrations](https://cotlet.dev/integrations.md) · [Use cases](https://cotlet.dev/use-cases.md) · [How it works](https://cotlet.dev/how-it-works.md) · [Pricing](https://cotlet.dev/pricing.md) · [Security](https://cotlet.dev/security.md)

**Resources:** [Blog](https://cotlet.dev/blog.md) · [API docs](https://cotlet.dev/docs.md) · [Help center](https://cotlet.dev/help.md) · [Changelog](https://cotlet.dev/changelog.md) · [GitHub](https://github.com/cotletdev/cotlet)

**Solutions:** [For developers](https://cotlet.dev/for-developers.md) · [For automation agencies](https://cotlet.dev/for-agencies.md)

**Company:** [About](https://cotlet.dev/about.md) · [AI info: company facts](https://cotlet.dev/ai-info.md) · [Contact](https://cotlet.dev/contact.md)

**Legal:** [Terms of service](https://cotlet.dev/terms) · [Privacy policy](https://cotlet.dev/privacy) · [Refund policy](https://cotlet.dev/refunds) · [Acceptable use](https://cotlet.dev/acceptable-use) · [Cookie policy](https://cotlet.dev/cookies) · [DPA](https://cotlet.dev/dpa) · [Subprocessors](https://cotlet.dev/subprocessors)

**Elsewhere:** [Status page](https://status.cotlet.dev) · [Cotlet on GitHub](https://github.com/cotletdev) · [Cotlet on X](https://x.com/cotletdev) · [Cotlet on LinkedIn](https://www.linkedin.com/company/cotletdev) · [Cotlet on Product Hunt](https://www.producthunt.com/products/cotlet) · [Cotlet on Crunchbase](https://www.crunchbase.com/organization/cotlet) · [Cotlet on SaaSHub](https://www.saashub.com/cotlet)

Cotlet.dev is built by Bart Krawczyk and Jake Slugocki, the founders of Take Group sp. z o.o., ul. Wincentego Janasa 4, 40-855 Katowice, Poland. KRS 0000871398, NIP 6342984273, VAT EU: PL6342984273. [About us](https://cotlet.dev/about.md)

Cotlet is an independent service. It is not affiliated with, endorsed by or sponsored by any of the products listed on this site. Product names are trademarks of their respective owners.