Sales leads

/api/v1/firsatlar — GET

GET/api/v1/firsatlar

Sales leads the assistant opened during calls (customers who agreed to be contacted), newest first; filter by sinif (sicak hot, ilik warm, soguk cold), durum and since. Phone, name and email are masked unless you enabled personal data in the Data API. For CRM sync, pair it with the firsat.olusturuldu webhook.

• Authentication: Authorization: Bearer rz_live_…
• Scope: firsat:read
• Plan feature: Data API + Sales leads — if off, the endpoint answers 404 not_found

Parameters

Name	In	Type	Limits	Meaning
durum	query	"yeni" | "iletisimde" | "teklif" | "kazanildi" | "kaybedildi" | null		Status filter: for carts e.g. terk (abandoned); for leads yeni, iletisimde, teklif, kazanildi, kaybedildi.
sinif	query	"sicak" | "ilik" | "soguk" | null		Lead class: sicak (hot), ilik (warm), soguk (cold).
since	query	string (date-time) | null		From this moment on (ISO 8601).
cursor	query	string | null		next_cursor from the previous response.
limit	query	integer	≥ 1, ≤ 100, default 50	Page size.

Example

curl -s "$RZ_API/api/v1/firsatlar?sinif=sicak&limit=50" -H "Authorization: Bearer $RZ_KEY"

Response 200

Error statuses: 401, 403, 404, 413, 422, 429 — see Errors and limits.

---

/api/v1/firsatlar/{lead_id} — GET

GET/api/v1/firsatlar/{lead_id}

A single sales lead; fields and masking as in the list. Leads from test calls return 404.

• Authentication: Authorization: Bearer rz_live_…
• Scope: firsat:read
• Plan feature: Data API + Sales leads — if off, the endpoint answers 404 not_found

Parameters

Name	In	Type	Limits	Meaning
lead_id *	path	string (uuid)		Sales lead id (UUID).

Example

curl -s "$RZ_API/api/v1/firsatlar/0199…" -H "Authorization: Bearer $RZ_KEY"

Response 200

Error statuses: 401, 403, 404, 413, 422, 429 — see Errors and limits.