POST list_customers
Customers matching a name, phone, email, address or tag, with last serviced date.
read
Returns customers with their contacts, service location and last serviced date. Use it before create_customer to find a repeat caller by phone or email. create_job and create_estimate take the customer name exactly as shown here.
POST /api/v1/service-fusion/list_customers
Input
| Parameter | Type | Description |
|---|---|---|
| query | string | Name, phone, email or address to search for. |
| tags | string[] | Only customers with these tags. |
| page | integer | Page number. Default: 1. |
Example response
{
"customers": [
{
"customer_id": "22814",
"customer_name": "Jane Doe",
"contact": {
"first_name": "Jane",
"last_name": "Doe",
"phone": "555-0142",
"email": "jane.doe@example.com"
},
"location": {
"street_1": "48 Maple Court",
"city": "Plano",
"state_prov": "TX",
"postal_code": "75024"
},
"tags": [
"Residential"
],
"last_serviced": "2026-04-18"
}
],
"page": 1
}