/api/v2/interview-slots

get

https://api.gupy.io/api/v2/interview-slots

Returns free slots for the interviewer within a datetime window (maximum 15 days from the effective start). startDate and endDate must be ISO-8601 datetimes with an explicit timezone offset (e.g. Z or ±HH:mm). When endDate is sent, the window is start through end within that limit. When endDate is omitted, the window end is start plus daysAheadToSuggestSpots (query param, 1–15 days, or company integration default, capped at 15).

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

applicationId

number

required

≥ 1

Application identifier owned by the authenticated company.

jobId

number

required

≥ 1

Job identifier associated with the application.

interviewerId

number

required

≥ 1

Company user who will conduct the interview and owns the calendar used for scheduling operations.

durationInMinutes

number

required

≥ 1

Interview duration in minutes.

startDate

date-time

Window start (ISO-8601 datetime with explicit timezone offset, e.g. Z or ±HH:mm). Defaults to the current instant when omitted. Values earlier than now are clamped to the current instant.

endDate

date-time

Window end (ISO-8601 datetime with explicit timezone offset, e.g. Z or ±HH:mm). When provided, must be after the effective start and at most 15 days later. When omitted, defaults to start plus daysAheadToSuggestSpots (query param or company integration setting, capped at 15 days).

daysAheadToSuggestSpots

number

1 to 15

Days ahead from the effective window start used only when endDate is omitted. Allowed range when sent: 1 to 15 days (inclusive). Defaults to company integration daysAheadToSuggestSpots when omitted.

timezone

string

IANA timezone for working hours. Defaults to company integration timezone.

Responses

400

Invalid or missing query parameters.

401

Bearer authorization token invalid.

403

User is not allowed to access this endpoint.

404

Feature disabled or application not found for the authenticated company.

422

Interviewer calendar is not connected via Meeting Scheduler OAuth.

200