List interview plans

List interview plans

Required scopes: interview_plans:read

Read-only. Returns published interview plans in the token organization, newest first, partitioned by the token live/test mode and filtered to what the caller may see under the department read boundary. Draft plans are not included here: list them with GET /v1/interview_plan_drafts. Pass job_id to return only the plans linked to one Job.

Example (curl):

curl 'https://api.yardstick.team/v1/interview_plans?limit=20' \
  -H 'Authorization: Bearer ys_sk_live_…'

Example (TypeScript):

await fetch("https://api.yardstick.team/v1/interview_plans?limit=20", {
  headers: { Authorization: `Bearer ${process.env.YS_API_KEY}` },
}).then((r) => r.json());