> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oneshotagent.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Field service

> Read clients, jobs, quotes and invoices from your connected field service system

## Overview

Read-only tools on a connected field service system ([Connections](https://docs.oneshotagent.com/api-reference/connections/overview.md)): Jobber. Nothing is created, scheduled, sent, approved or archived; nothing fetched is kept.

* `POST /v1/tools/field_service/clients` (`field_service_clients`)
* `POST /v1/tools/field_service/jobs` (`field_service_jobs`)
* `POST /v1/tools/field_service/quotes` (`field_service_quotes`)
* `POST /v1/tools/field_service/invoices` (`field_service_invoices`)

All take `connection_id`: list your connections (`GET /v1/connections` or `oneshot_connections_list`) and pick by `system` and `account_label`. Agent tools: `oneshot_field_service_clients`, `oneshot_field_service_jobs`, `oneshot_field_service_quotes`, `oneshot_field_service_invoices`.

## Authentication

Requires x402 payment in the `payment-signature` header. Refusals for the body, the connection or an unavailable system come before payment and are not charged.

## Request

| Field | Tools | Meaning |
| - | - | - |
| `connection_id` | all | Required. |
| `limit`, `cursor` | all | Page size 1 to 100 (default 25); the previous page's `next_cursor`. |
| `query` | clients | Matches name, company, email, phone or property. |
| `updated_since` | clients | Changed on or after this day (`YYYY-MM-DD`, UTC). |
| `client_id` | jobs, quotes, invoices | Only this client's records, by the clients tool's `id`. |
| `status` | jobs | `upcoming`, `active`, `late`, `completed` (work done, invoiced or not) or `all` (default). |
| `status` | quotes | `draft`, `awaiting_response`, `approved`, `converted`, `archived` or `all`. |
| `status` | invoices | `draft`, `awaiting_payment`, `past_due`, `paid` or `all`. |
| `scheduled_after`, `scheduled_before` | jobs | Jobs with a visit in this window of days. |
| `sent_after` | quotes | Last sent to the client on or after this day. |
| `due_before` | invoices | Due on or before this day. |

```json theme={null}
{ "connection_id": "5f4a3b2c-1d0e-4f9a-8b7c-6d5e4f3a2b1c", "status": "upcoming", "scheduled_after": "2026-10-21", "scheduled_before": "2026-10-21", "limit": 25 }
```

Jobber's listings take no client filter on jobs and no send-date filter on quotes, so those two filters narrow each page after the read; follow `next_cursor` until null.

## Response (200)

`next_cursor` goes back as `cursor` (null on the last page). Each record carries `source` (`system`, `id`). `currency` is null when the system states none; other missing fields are null.

**data.clients** `array`

`id`, `name`, `company`, `emails`, `phones`, `address`, `tags`, `balance` (owed), `updated_at`, `source`.

**data.jobs** `array`

`id`, `number`, `title`, `client` (`id`, `name`), `status` (`upcoming`, `active`, `late`, `completed`, `on_hold`, `unscheduled`, `action_required`), `total`, `currency`, `visits` (`id`, `starts_at`, `ends_at`, `assigned_to`, `completed`), `source`.

**data.quotes** `array`

`id`, `number`, `client`, `status` (`draft`, `awaiting_response`, `changes_requested`, `approved`, `converted`, `archived`), `total`, `currency`, `sent_at`, `approved_at`, `source`.

**data.invoices** `array`

`id`, `number`, `client`, `status` (`draft`, `awaiting_payment`, `past_due`, `paid`, `bad_debt`), `total`, `balance` (still owed), `currency`, `issued_at`, `due_at`, `source`.

```json theme={null}
{
  "success": true,
  "data": {
    "invoices": [
      { "id": "aW52b2ljZV81MDAx", "number": "5001", "client": { "id": "Y2xpZW50XzEwMDE", "name": "Dana Reyes" }, "status": "past_due", "total": 480, "balance": 480, "currency": null, "issued_at": "2026-09-15", "due_at": "2026-10-15", "source": { "system": "jobber", "id": "aW52b2ljZV81MDAx" } }
    ],
    "next_cursor": null
  }
}
```

## Errors

| Status | Error | Meaning |
| - | - | - |
| 400 | `invalid_request` | Invalid body. |
| 400 | `connection_wrong_system` | Not a field service connection. |
| 404 | `connection_not_found` | No such connection. |
| 409 | `connection_expired`, `connection_revoked`, `connection_not_active` | Reconnect or start again. |
| 503 | `not_configured` | System unavailable right now. |
| 503 | `rate_limited`, `system_unavailable` | Busy or no answer; the charge is returned as credit. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.