ServiceTitan API Pagination, Fields & Errors
ServiceTitan API pagination with limit and offset, field selection, and stable error codes — one request shape via MindCloud.
Once your first ServiceTitan request works, use this page to shape real production requests. MindCloud keeps the app-specific API details behind one REST format, so you can control arguments, pagination, filtering, fields, and errors without learning a separate convention for every provider. If you have not connected ServiceTitan yet, start with Connect to ServiceTitan.
Arguments
Arguments are the inputs an action needs. Put them in the JSON body under the arguments field. Each ServiceTitan action page documents its exact argument keys and types. It also shows which arguments are required. Keys are case-sensitive. Requests with missing or invalid required arguments fail.
Request format
Choose a ServiceTitan action and send a POST request to its Universal API run URL. Authenticate with your MindCloud API Key. Put the connection, arguments, and response controls in the JSON body.
| Piece | Where it goes |
|---|---|
arguments | An object in the JSON body. Put all action fields inside it. |
connectionId | An optional public connection id in the JSON body. The API selects the default or only valid connection when omitted. |
limit, offset, where, sort, fields | Response controls in the JSON body. |
Pagination
Paginated list actions accept limit and offset in the JSON body. Some providers use page numbers, and some use cursors. MindCloud translates the request for ServiceTitan. Start at offset=0, add limit to the offset after each page, and stop when a page returns fewer rows than you asked for.
curl --request POST \
--url "https://connect.mindcloud.co/v2/universal/apps/servicetitan/actions/list-activity-codes/run" \
--header "Authorization: Bearer $MINDCLOUD_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"connectionId": "$CONNECTION_ID",
"arguments": {},
"limit": "25",
"offset": "0"
}'These ServiceTitan actions support pagination:
- Create Customer
- Get Appointment Assignments
- Get Appointments
- Get Bookings
- Get Business Units
- Get Call Reasons
- Get Campaigns
- Get Customer By Id
- Get Customers
- Get Discount and Fees
- Get Employees
- Get Equipments
- Get Invoices
- Get Invoices By Job Id
- Get Item Receipts
- Get Job Types
- Get Jobs
- Get Locations
- Get Materials
- Get Payment Types
- Get Payments
- Get Project
- Get Project Statuses
- Get Project Sub Statuses
- Get Project Types
- Get Projects
- Get Purchase Orders
- Get Report Data
- Get Returns
- Get Services
- Get Services by Id
- Get Tasks
- Get Technicians
- List Activities
- List Customer Contact
- List Customers Contacts
- List Dynamic Set Values
- List Memberships
- List Payroll
- List Purchase Order Types
- List Report Categories
- List Reports
- List Vendors
- Update Costumer
Field selection
Use the fields body field to return only the response fields your code reads. Use dot notation for nested objects: fields=id,name,profile.email. Selection is applied to each row in data after the response is mapped, and id is kept whenever it exists so rows stay identifiable.
Responses and errors
Every ServiceTitan response is mapped into the same public envelope before it reaches your code: success, your rows in a data array (single-row actions return an array with one item), and optional meta. Failed requests return success: false with a stable code to branch on and a human-readable message:
{
"success": false,
"code": "CONNECTION_APP_MISMATCH",
"message": "Connection \"conn_123\" is not configured for this app."
}Check the HTTP status first: 401 or 403 for authentication and authorization, 400 for invalid request shape, and 5xx when MindCloud cannot complete the action upstream. Most failures come from a missing API Key, a missing or mismatched connection, or arguments that do not match the action page.