# Fair leads

> Potential customers collected at a trade fair booth — quick capture, owner, next action, and conversion to a company.

A fair lead (`lead` in the API) is the first record of a company you met at a trade fair. A lead isn't a company yet: once it's qualified and moved to the **Converted** (*Aktarıldı*) status, a company, a person, and, if needed, an opportunity are created (from the web interface). Fairs (`fair`) group leads; each fair has a name, city, venue, and dates.

## Status

| `status` | Meaning |
|---|---|
| `Yeni` | New — captured at the booth. |
| `İletişime geçildi` | Contacted — first contact made after the fair. |
| `Teklif verildi` | Quote sent. |
| `Aktarıldı` | Converted to a company (`customer_id` and `opp_id` are filled in). |
| `Vazgeçildi` | Dropped — won't be followed up. |

`status_eff` returns the displayed status: `Kazanıldı` (won) if the linked project was won, `Kaybedildi` (lost) if it was lost or canceled, and the stored status otherwise.

## Fields

| Field | Type | Description |
|---|---|---|
| `id`, `rid` | integer, string | ID and permanent record ID (`00Q…`). |
| `fair_id`, `fair` | integer, string | Fair. |
| `company`, `contact_name`, `title`, `phone`, `email` | string | Company and contact details. |
| `city`, `sector`, `website` | string | Company details. |
| `visitor_type` | string | `Potansiyel müşteri` (potential customer), `Mevcut müşteri` (existing customer), `Tedarikçi` (supplier), `Rakip` (competitor), `Diğer` (other). |
| `interest` | string | Interest: `Sıcak` (hot), `Ilık` (warm), `Soğuk` (cold). |
| `products`, `products_text` | string | IDs of the products of interest (comma-separated) and free text. |
| `potential_kg`, `unit` | number, string | Monthly potential and unit. |
| `timing` | string | `Hemen` (immediately), `3 ay içinde` (within 3 months), `6 ay içinde` (within 6 months), `1 yıl+` (1 year+), `Belirsiz` (unknown). |
| `next_action`, `next_date` | string, date | Next action and its date — creates a task for the owner. |
| `owner` | user | The sales rep who will follow up on the lead. |
| `customer_id`, `opp_id`, `task_id` | integer | Company and opportunity, if converted; follow-up task. |

## Owner and follow-up task

The person who captures a lead and the person who follows it up can be different (`owner_id`). When a next action and date are entered, a task is created for the owner; when the lead is updated, the task is updated too. By default, sales reps see only their own leads (`owner=me`).

## Related endpoints

:::cards
- [List fairs](/rest-api/fairs/list) flag | Fairs and their lead counts.
- [Add a lead](/rest-api/fairs/leads-create) plus | Quick capture at the booth.
- [Update a lead](/rest-api/fairs/leads-update) pencil | Status and fields.
:::