---
title: "Qualify"
method: POST
path: "/api/qualify"
tags: ["Qualify"]
---

# Qualify

`POST /api/qualify`

## Request

- Base URL: `https://api.ruzora.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ruzora.com/api/qualify`
- Auth: none declared

Public endpoint — gates cold inbound traffic before the calendar.

## Request body

- QualifySubmission: Answers from the /qualify wizard. utm_* / referrer / landing pages come from WebAttributionMixin (www first-touch attribution), truncated never rejected.
  - `utm_source` string, nullable
  - `utm_medium` string, nullable
  - `utm_campaign` string, nullable
  - `utm_content` string, nullable
  - `utm_term` string, nullable
  - `referrer_url` string, nullable
  - `landing_page` string, nullable
  - `first_touch_landing_page` string, nullable
  - `full_name` string, required
  - `work_email` string, email, required
  - `company` string, nullable
  - `intent` 'hire_engineers' | 'build_project' | 'refactor_rescue' | 'researching', required
  - `role_count` 'one' | 'two_three' | 'four_plus' | 'not_sure', nullable
  - `budget` 'under_15k' | '15_to_50k' | '50_to_150k' | 'over_150k' | 'not_sure', nullable
  - `runway` 'lt_6mo' | '6_12mo' | '12_18mo' | '18_plus_mo' | 'bootstrapped_no_revenue', nullable
  - `seat_budget` 'lt_4500' | '4500_5999' | '6000_7999' | '8000_plus' | 'not_sure', nullable
  - `timing` 'asap' | 'within_month' | 'one_to_three_months' | 'three_plus' | 'no_timeline', required
  - `role` 'founder_ceo' | 'cto_vp_eng' | 'eng_manager' | 'hr_ops_finance' | 'other', required
  - `referrer_origin` string, nullable

## Response `200`

Successful Response

- QualifyResponse
  - `qualified` boolean, required
  - `redirect_url` string, required
  - `off_ramp_reason` string, nullable
  - `lead_id` string, nullable
  - `qualify_band` string, nullable
  - `qualify_disqualify_reason` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api.md) · [All operations](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/revisions/f9b8223f3ac4?raw)