Visit Timers

List visit timers

Returns a paginated list of visit timers for the authenticated company. Visit timers track the time technicians spend on a scheduled visit and are commonly used for payroll. Results are ordered by start time (newest first).

GET

/visit-timers

List visit timers

curl --request GET \
  --url 'https://api.getrotor.com/open-api/visit-timers?page=1&limit=50&user_id=550e8400-e29b-41d4-a716-446655440000&job_id=3c90c3cc-0d44-4b50-8888-8dd25736052a&visit_id=4521&start_date=2026-01-01T00%3A00%3A00Z&end_date=2026-01-31T23%3A59%3A59Z' \
  --header 'x-api-key: <api-key>' \
  --header 'rotor-api-version: 1.1.0'

{
  "data": [
    {
      "assigned_to": [
        {
          "email": "<string>",
          "name": "<string>",
          "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        }
      ],
      "duration_minutes": 90,
      "end": "2023-11-07T05:31:56Z",
      "end_location": [
        40.7128,
        -74.006
      ],
      "id": "12345",
      "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "start": "2023-11-07T05:31:56Z",
      "start_location": [
        40.7128,
        -74.006
      ],
      "visit_id": 4521
    }
  ],
  "pagination": {
    "has_more": true,
    "limit": 50,
    "page": 1,
    "total": 142
  },
  "status": "success"
}

Authorizations

x-api-keystringheaderrequired

Company API key in the format: rotor_{keyId}_{keySecret}

To obtain an API key:

Log into your Rotor dashboard
Go to Settings → Integrations → API Keys
Create a new key and select the scopes you need
Copy the key — it's only shown once!

Query Parameters

pageintegerquerydefault:1

Page number (1-based)

Required range: 1 <= x

Example: 1

limitintegerquerydefault:50

Number of results per page (max 1000)

Required range: 1 <= x <= 1000

Example: 50

user_idstringquery

Filter to visit timers a given user is assigned to

Example: 550e8400-e29b-41d4-a716-446655440000

job_idstringquery

Filter visit timers by the job they belong to

visit_idintegerquery

Filter visit timers by the visit they belong to

Example: 4521

start_datestringquery

Only include visit timers that started on or after this date-time (ISO 8601)

Example: 2026-01-01T00:00:00Z

end_datestringquery

Only include visit timers that started on or before this date-time (ISO 8601)

Example: 2026-01-31T23:59:59Z

Headers

rotor-api-versionenum<string>headerdefault:1.1.0required

Required OpenAPI version header.

Available options: 1.1.0

Example: 1.1.0

Response

Visit timers listed successfully

dataobject[]

Show child attributes

paginationobject

Show child attributes

statusstring

Example: success

Still need help? Ask the team