ServiceTrade API

14 endpoints for ServiceTrade, each at its own method and path, called with your API key. Open an endpoint for its inputs, examples and response.

Base URL: https://cotlet.dev/api/v1/servicetrade
Connects with: Your own ServiceTrade login (office user or admin). What your agent can do follows the roles and permissions on your account.
Integration page: ServiceTrade

Read (9)

Return data and change nothing in the account.

ServiceTrade Endpoints: Read
Endpoint	Description
GET /jobs	List jobs filtered by status, location, customer, technician or due date.
GET /jobs/{job_id}	Read one job with its services, appointments and notes.
GET /appointments	List appointments by status, technician, job or time window.
GET /service-requests	List the services on jobs and quotes by status, job, location or deficiency.
GET /deficiencies	List deficiencies found on inspections by severity, status, resolution or location.
GET /quotes	List quotes by status, customer, location or date.
GET /quotes/{quote_id}	Read one quote with its line items and services.
GET /locations	List customer locations by name, company or status.
GET /technicians	List the technicians of your company.

Change the account. Calls marked Confirm wait for the user to approve them.

ServiceTrade Endpoints: Write
Endpoint	Description
POST /jobs/{job_id}/appointments Confirm	Book an appointment for a job with a technician and a time window.
PATCH /appointments/{appointment_id} Confirm	Change an appointment: status, window, technicians or release it.
POST /locations/{location_id}/quotes Confirm	Create a quote for services at a location, as a draft.
POST /quotes/{quote_id}/submit Confirm	Submit a draft quote so the customer can review and approve it.
POST /entities/{entity_id}/comments Confirm	Add a comment to a job, location, quote or deficiency.