Search reporting

Search reporting

Required scopes: reporting:read

Read-only bounded recruiting reporting. query_family must be one of the canonical V1 reporting families; window_start and window_end are required; mode comes from the API token and cannot be overridden by livemode. Exact job_id and job_posting_id scopes fail closed for legacy reporting families until exact scoped reporting aggregations are available; prospect_ops_summary can use exact Job or Job Posting context for deterministic Prospect CRM operations counts. role_label remains an exact legacy fallback for non-prospect families. Responses expose counts, data-gap labels, canonical display ids, and dashboard links, and never expose raw scorecard notes, interviewer notes, decision brief text, emails, source internals, ROI, diversity, predictive, retention, or post-hire metrics.

Example (curl):

curl 'https://api.yardstick.team/v1/reporting/search?query_family=role_health_attention&window_start=2026-05-01&window_end=2026-05-26&role_label=AI%20Content%20Manager' \
  -H 'Authorization: Bearer ys_sk_live_…'

Example (TypeScript):

await fetch(
  "https://api.yardstick.team/v1/reporting/search?query_family=role_health_attention&window_start=2026-05-01&window_end=2026-05-26&role_label=AI%20Content%20Manager",
  { headers: { Authorization: `Bearer ${process.env.YS_API_KEY}` } },
).then((r) => r.json());