Field service
curl --request POST \
--url https://win.oneshotagent.com/v1/tools/field_service/clientsimport requests
url = "https://win.oneshotagent.com/v1/tools/field_service/clients"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://win.oneshotagent.com/v1/tools/field_service/clients', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://win.oneshotagent.com/v1/tools/field_service/clients",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://win.oneshotagent.com/v1/tools/field_service/clients"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://win.oneshotagent.com/v1/tools/field_service/clients")
.asString();require 'uri'
require 'net/http'
url = URI("https://win.oneshotagent.com/v1/tools/field_service/clients")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body{
"data.clients": [
{}
],
"data.jobs": [
{}
],
"data.quotes": [
{}
],
"data.invoices": [
{}
]
}Connections
Field service
Read clients, jobs, quotes and invoices from your connected field service system
POST
/
v1
/
tools
/
field_service
/
clients
Field service
curl --request POST \
--url https://win.oneshotagent.com/v1/tools/field_service/clientsimport requests
url = "https://win.oneshotagent.com/v1/tools/field_service/clients"
response = requests.post(url)
print(response.text)const options = {method: 'POST'};
fetch('https://win.oneshotagent.com/v1/tools/field_service/clients', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://win.oneshotagent.com/v1/tools/field_service/clients",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://win.oneshotagent.com/v1/tools/field_service/clients"
req, _ := http.NewRequest("POST", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://win.oneshotagent.com/v1/tools/field_service/clients")
.asString();require 'uri'
require 'net/http'
url = URI("https://win.oneshotagent.com/v1/tools/field_service/clients")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
response = http.request(request)
puts response.read_body{
"data.clients": [
{}
],
"data.jobs": [
{}
],
"data.quotes": [
{}
],
"data.invoices": [
{}
]
}Overview
Read-only tools on a connected field service system (Connections): 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)
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 thepayment-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. |
{ "connection_id": "5f4a3b2c-1d0e-4f9a-8b7c-6d5e4f3a2b1c", "status": "upcoming", "scheduled_after": "2026-10-21", "scheduled_before": "2026-10-21", "limit": 25 }
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.
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.id, number, client, status (draft, awaiting_response, changes_requested, approved, converted, archived), total, currency, sent_at, approved_at, source.id, number, client, status (draft, awaiting_payment, past_due, paid, bad_debt), total, balance (still owed), currency, issued_at, due_at, source.{
"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. |