API Docs
Voxbi Cockpit APIs
All endpoints

List the home office requests waiting on you to decide (user)

The home office requests this employee is asked to decide, newest first.

One entry per day-row: a home office request for a week is stored as a row per day, each decided on its own, and each carrying its own id and place in the chain. Read dates rather than start/end. Requests to take back already approved days are included, marked sub_type: removal.

Read off the approval rows addressed to them, so approval chains are honoured exactly as the decision endpoints honour them: which step holds the request, watchers, self-approval grants, and restarts. Requests at a step below theirs are included with can_decide_now: false, so a validator further up a chain sees what is coming rather than having it appear from nowhere.

Your own employee record only: another employee's id returns 403, since a queue is built from rows addressed to one person.

One endpoint per request type, matching how the work is looked at: a screen showing one type pages that type, instead of over-fetching a mixed feed and filtering it. The sibling queues are pending-requests/absences, pending-requests/home-office and pending-requests/time-point-corrections; GET /v2/{pbx}/employee/{employee}/validator reports how many are waiting in each.

HTTP: bearerAuth

User bearer token. Default authentication for customer-facing endpoints. Obtain a token by calling POST /login with your credentials, then send it on every subsequent request as Authorization: Bearer <token>. The token inherits the permissions and PBX scope of the authenticated user.

HTTP Authorization Scheme
bearer
Bearer format
Bearer <token>
pbx path · string · uuid *
UUID of the PBX tenant. Must be the tenant the token belongs to; anything else is refused with 403 rather than answered from another tenant.
employee_id path · string · uuid *
UUID of the Tempus employee whose queue this is. Must be the caller's own employee record: a queue is built from the approval rows addressed to one person, so another employee's id is refused rather than quietly answered with your own.
page query · integer
Page number to return.
per_page query · integer
Number of entries per page.
filter[requester_id] query · string · uuid
Narrow the queue to one person who raised requests. Named `requester_id` rather than `employee_id` because the employee in the path is the validator: these routes have two employees in play. A requester you hold no rows on yields an empty page rather than a 403, since nothing was hidden from you.
accept header · string
example: application/json

Responses

OK. Paginated home office day-rows waiting on this employee.
Response schema
data*array<object>
[]object
pagination*object
page*integer
example: 1
total_pages*integer
example: 2
total*integer
example: 14
per_page*integer
example: 10
Authorization Token Missing. This error is returned when the authorization token is missing.
Response schema
errorstring
Error message
example: Authorization Token is missing
Forbidden. The caller is outside this PBX, or asked for an employee record that is not their own.
Response schema
messagestring
example: You do not have access to this PBX.
Not found. No such employee in this PBX.
Response schema
messagestring
example: User not found.
Unprocessable Parameters. This error is returned when a parameter is not valid.
Response schema
messagestring
example: The given data was invalid.
errorsobject
filterarray<string>
[]string
sortarray<string>
[]string
pagearray<string>
[]string
per_pagearray<string>
[]string
get https://cockpit.voxbi.com/api/v1/v2/{pbx}/employee/{employee}/pending-requests/home-office
Base URL
Request sample 
curl -X GET 'https://cockpit.voxbi.com/api/v1/v2/{pbx}/employee/{employee}/pending-requests/home-office' \
  -H 'Authorization: Bearer YOUR_TOKEN'
const response = await fetch('https://cockpit.voxbi.com/api/v1/v2/{pbx}/employee/{employee}/pending-requests/home-office', {
  method: 'GET',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Bearer ${YOUR_TOKEN}`,
  },
});

const data = await response.json();
console.log(data);
import requests

response = requests.get('https://cockpit.voxbi.com/api/v1/v2/{pbx}/employee/{employee}/pending-requests/home-office',
    headers={'Authorization': f'Bearer {YOUR_TOKEN}'}
)
response.raise_for_status()
data = response.json()
print(data)
<?php
$context = stream_context_create([
    'http' => [
        'method'  => 'GET',
        'header'  => "Content-Type: application/json\r\nAuthorization: Bearer YOUR_TOKEN",
    ],
]);

$response = file_get_contents('https://cockpit.voxbi.com/api/v1/v2/{pbx}/employee/{employee}/pending-requests/home-office', false, $context);
$data = json_decode($response, true);
print_r($data);
{ … }
"data": [ … ],
{ … }
"id": "550e8400-e29b-41d4-a716-446655440010",
"type": "home_office",
"sub_type": null,
"status": "pending",
"employee_id": "550e8400-e29b-41d4-a716-446655440001",
"employee": { … },
"employee_id": "550e8400-e29b-41d4-a716-446655440001",
"first_name": "Anna",
"last_name": "Muller",
"name": "Muller Anna"
},
"requested_by": null,
"company_id": "550e8400-e29b-41d4-a716-446655440005",
"start": "2026-03-04T00:00:00+00:00",
"end": "2026-03-04T00:00:00+00:00",
"dates": [ … ],
"2026-03-04"
],
"requested_time": { … },
"2026-03-04": 28800
},
"requested_seconds": 28800,
"comment": null,
"created": "2026-03-01T09:12:00+00:00",
"modified": "2026-03-01T09:12:00+00:00",
"validators": [ … ],
{ … }
"employee_id": "550e8400-e29b-41d4-a716-446655440020",
"name": "Lemaire Farid",
"status": "pending",
"comment": null,
"step_position": 1,
"watcher": false,
"mandatory": false
}
],
"can_decide_now": true,
"watcher": false,
"step": { … },
"position": 1,
"total": 2,
"name": "Team lead",
"status": "active",
"required": 1,
"mandatory": false
},
"awaiting": []
}
],
"pagination": { … }
"page": 1,
"total_pages": 2,
"total": 14,
"per_page": 10
}
}
{ … }
"error": "Authorization Token is missing"
}
Cache-Control string
example: private, must-revalidate
Connection string
example: keep-alive
Content-Type string
example: application/json
Vary string
example: Origin
X-RateLimit-Limit integer
Max requests allowed in the current rate-limit window.
example: 60
X-RateLimit-Remaining integer
Requests remaining in the current rate-limit window.
example: 57
No example for this status.
No example for this status.
{ … }
"errors": { … }
"filter": [ … ],
"The filter field must be an array."
],
"sort": [ … ],
"The sort field must be a string."
],
"page": [ … ],
"The page field must be an integer."
],
"per_page": [ … ]
"The per page field must be an integer."
]
}
}
Cache-Control string
example: private, must-revalidate
Connection string
example: keep-alive
Content-Type string
example: application/json
Vary string
example: Origin
X-RateLimit-Limit integer
Max requests allowed in the current rate-limit window.
example: 60
X-RateLimit-Remaining integer
Requests remaining in the current rate-limit window.
example: 57