List appointments of a candidate
Returns a cursor-paginated list of the appointments planned for a candidate, soonest first. Cancelled appointments are included and flagged with isCancelled. Use startTimeSince / startTimeUntil to bound the period.
Authorizations
API key for authentication. Get your API key from Settings → API Keys in your Spott dashboard.
Query Parameters
Identifier of the candidate whose appointments should be returned.
1Number of appointments to return per page (min: 1, max: 50, default: 25).
1 <= x <= 5025
Opaque cursor string for pagination. Use the cursor value from a previous response to fetch the next page. Omit for the first page.
Only return appointments starting on or after this moment. Pass the current time to receive upcoming appointments only. If omitted, no lower bound is applied.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$"2026-08-01T00:00:00.000Z"
Only return appointments starting on or before this moment. If omitted, no upper bound is applied.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$"2026-08-31T23:59:59.999Z"