Record what a site visit found
LogsPOST /site-visits/{id}/complete
With quote lines, the revised quote is issued from the outcome at once; otherwise the request awaits a quote.
Parameters
idID of the scheduled site visit in the caller's tenant to record as completed.
Body application/json
outcomequoteShow child attributes
linesShow child attributes
charge_codeA price key from quote-prices; omit for a free line
descriptionquantityDefaults to 1
unit_price_centsOverrides the tariff price (with a reason) or prices a free line
taxableFree lines only; defaults to
trueadjustment_reason
valid_untilDefaults to 30 days from today
notessite_visit_idThe visit this quote follows
Returns
200 Completed visit, with quote_id when a quote was issued
Show attributes
idtenant_idrequest_idstatusone of
scheduled,completed,cancelledvisit_datebooked_byone of
consumer,staffnotesoutcomequote_idcompleted_atcancelled_atcreated_atupdated_at
Permissions connections:write · Roles: admin, operations, owner
curl -X POST "$BUSINESS_API/site-visits/{id}/complete" \
-H "Authorization: Bearer sk_test_..." \
-H "Content-Type: application/json" \
-d '{
"outcome": "outcome",
"quote": {
"lines": [
{
"charge_code": "CHA-2026-000142",
"description": "Leitura confirmada no local.",
"quantity": 1,
"unit_price_cents": 125000,
"taxable": true,
"adjustment_reason": "adjustment reason"
}
],
"valid_until": "2026-11-19",
"notes": "Leitura confirmada no local.",
"site_visit_id": "sit_2ljUKXviQDVcG3dOWH1ysvVGYfL"
}
}'
# No matching CLI command; use cURL or direct HTTP.
const res = await fetch("$BUSINESS_API/site-visits/{id}/complete", {
method: "POST",
headers: {
Authorization: "Bearer sk_test_...",
"Content-Type": "application/json"
},
body: JSON.stringify({
"outcome": "outcome",
"quote": {
"lines": [
{
"charge_code": "CHA-2026-000142",
"description": "Leitura confirmada no local.",
"quantity": 1,
"unit_price_cents": 125000,
"taxable": true,
"adjustment_reason": "adjustment reason"
}
],
"valid_until": "2026-11-19",
"notes": "Leitura confirmada no local.",
"site_visit_id": "sit_2ljUKXviQDVcG3dOWH1ysvVGYfL"
}
})
});
const data = await res.json();
import requests
res = requests.post(
"$BUSINESS_API/site-visits/{id}/complete",
headers={
"Authorization": "Bearer sk_test_..."
},
json={
"outcome": "outcome",
"quote": {
"lines": [
{
"charge_code": "CHA-2026-000142",
"description": "Leitura confirmada no local.",
"quantity": 1,
"unit_price_cents": 125000,
"taxable": true,
"adjustment_reason": "adjustment reason"
}
],
"valid_until": "2026-11-19",
"notes": "Leitura confirmada no local.",
"site_visit_id": "sit_2ljUKXviQDVcG3dOWH1ysvVGYfL"
}
}
)
data = res.json()
body := strings.NewReader(`{
"outcome": "outcome",
"quote": {
"lines": [
{
"charge_code": "CHA-2026-000142",
"description": "Leitura confirmada no local.",
"quantity": 1,
"unit_price_cents": 125000,
"taxable": true,
"adjustment_reason": "adjustment reason"
}
],
"valid_until": "2026-11-19",
"notes": "Leitura confirmada no local.",
"site_visit_id": "sit_2ljUKXviQDVcG3dOWH1ysvVGYfL"
}
}`)
req, _ := http.NewRequest("POST", "$BUSINESS_API/site-visits/{id}/complete", body)
req.Header.Set("Authorization", "Bearer sk_test_...")
req.Header.Set("Content-Type", "application/json")
resp, err := http.DefaultClient.Do(req)
{
"id": "sit_2ljUKXviQDVcG3dOWH1ysvVGYfL",
"tenant_id": "ten_2ugFXIC316WXzGu1HGal90AxTA6",
"request_id": "req_2JrY4JziCp1C0bFCSLb4M37qGNH",
"status": "scheduled",
"visit_date": "2026-11-19",
"booked_by": "consumer",
"notes": "Leitura confirmada no local.",
"outcome": "outcome",
"quote_id": "quo_26mh1wUlhIGz1c4BTWQl9M2dDyI",
"completed_at": "2026-11-19T09:30:00Z",
"cancelled_at": "2026-11-19T09:30:00Z",
"created_at": "2026-11-19T09:30:00Z",
"updated_at": "2026-11-19T09:30:00Z"
}