Search Leads

GET

https://ops.hugin.co/api/v1/leads

GET

/api/v1/leads

$ curl -G https://ops.hugin.co/api/v1/leads \
>      -H "Authorization: Bearer <token>" \
>      -d taxId=44171346178

1 {
2   "status": "SUCCESS",
3   "data": {
4     "leads": [
5       {
6         "leadId": 2500435,
7         "leadStatus": "new",
8         "devices": []
9       },
10       {
11         "leadId": 2500433,
12         "leadStatus": "new",
13         "devices": []
14       },
15       {
16         "leadId": 2500391,
17         "leadStatus": "new",
18         "devices": []
19       },
20       {
21         "leadId": 2500383,
22         "leadStatus": "new",
23         "devices": []
24       },
25       {
26         "leadId": 2500350,
27         "leadStatus": "new",
28         "devices": [
29           {
30             "deviceId": "FT80000072",
31             "deviceStatus": "new",
32             "statusDescription": "Mali değil"
33           }
34         ]
35       },
36       {
37         "leadId": 2500349,
38         "leadStatus": "new",
39         "devices": [
40           {
41             "deviceId": "FT80000115",
42             "deviceStatus": "new",
43             "statusDescription": "Mali değil"
44           }
45         ]
46       },
47       {
48         "leadId": 2500320,
49         "leadStatus": "new",
50         "devices": []
51       },
52       {
53         "leadId": 2500297,
54         "leadStatus": "new",
55         "devices": [
56           {
57             "deviceId": "FT30007256",
58             "deviceStatus": "new",
59             "statusDescription": "Mali değil"
60           }
61         ]
62       },
63       {
64         "leadId": 2500296,
65         "leadStatus": "new",
66         "devices": []
67       },
68       {
69         "leadId": 2500295,
70         "leadStatus": "new",
71         "devices": []
72       },
73       {
74         "leadId": 2500294,
75         "leadStatus": "new",
76         "devices": []
77       },
78       {
79         "leadId": 2500293,
80         "leadStatus": "new",
81         "devices": []
82       },
83       {
84         "leadId": 2500281,
85         "leadStatus": "new",
86         "devices": []
87       },
88       {
89         "leadId": 2500267,
90         "leadStatus": "new",
91         "devices": [
92           {
93             "deviceId": "FT40005050",
94             "deviceStatus": "new",
95             "statusDescription": "Mali değil"
96           },
97           {
98             "deviceId": "FT40005005",
99             "deviceStatus": "new",
100             "statusDescription": "Mali değil"
101           }
102         ]
103       },
104       {
105         "leadId": 2500266,
106         "leadStatus": "new",
107         "devices": [
108           {
109             "deviceId": "FT40005041",
110             "deviceStatus": "new",
111             "statusDescription": "Mali değil"
112           }
113         ]
114       },
115       {
116         "leadId": 2500265,
117         "leadStatus": "new",
118         "devices": [
119           {
120             "deviceId": "FT40005040",
121             "deviceStatus": "new",
122             "statusDescription": "Mali değil"
123           },
124           {
125             "deviceId": "FT40005027",
126             "deviceStatus": "new",
127             "statusDescription": "Mali değil"
128           },
129           {
130             "deviceId": "FT40005012",
131             "deviceStatus": "new",
132             "statusDescription": "Mali değil"
133           }
134         ]
135       },
136       {
137         "leadId": 2500264,
138         "leadStatus": "new",
139         "devices": [
140           {
141             "deviceId": "FT40005009",
142             "deviceStatus": "new",
143             "statusDescription": "Mali değil"
144           }
145         ]
146       },
147       {
148         "leadId": 2500248,
149         "leadStatus": "new",
150         "devices": [
151           {
152             "deviceId": "FT40005033",
153             "deviceStatus": "new",
154             "statusDescription": "Mali değil"
155           }
156         ]
157       },
158       {
159         "leadId": 2500247,
160         "leadStatus": "new",
161         "devices": [
162           {
163             "deviceId": "FT30005972",
164             "deviceStatus": "new",
165             "statusDescription": "Mali değil"
166           }
167         ]
168       },
169       {
170         "leadId": 2500242,
171         "leadStatus": "new",
172         "devices": [
173           {
174             "deviceId": "FT40005034",
175             "deviceStatus": "new",
176             "statusDescription": "Mali değil"
177           }
178         ]
179       },
180       {
181         "leadId": 2500241,
182         "leadStatus": "new",
183         "devices": [
184           {
185             "deviceId": "FT40005010",
186             "deviceStatus": "new",
187             "statusDescription": "Mali değil"
188           }
189         ]
190       },
191       {
192         "leadId": 2500240,
193         "leadStatus": "new",
194         "devices": [
195           {
196             "deviceId": "FT40005003",
197             "deviceStatus": "new",
198             "statusDescription": "Mali değil"
199           }
200         ]
201       },
202       {
203         "leadId": 2500239,
204         "leadStatus": "new",
205         "devices": [
206           {
207             "deviceId": "FT40005019",
208             "deviceStatus": "new",
209             "statusDescription": "Mali değil"
210           }
211         ]
212       },
213       {
214         "leadId": 2500234,
215         "leadStatus": "new",
216         "devices": [
217           {
218             "deviceId": "FT30008358",
219             "deviceStatus": "new",
220             "statusDescription": "Mali değil"
221           }
222         ]
223       },
224       {
225         "leadId": 2500226,
226         "leadStatus": "new",
227         "devices": [
228           {
229             "deviceId": "FT40005011",
230             "deviceStatus": "new",
231             "statusDescription": "Mali değil"
232           }
233         ]
234       },
235       {
236         "leadId": 2500221,
237         "leadStatus": "new",
238         "devices": [
239           {
240             "deviceId": "FT30006586",
241             "deviceStatus": "new",
242             "statusDescription": "Mali değil"
243           }
244         ]
245       },
246       {
247         "leadId": 2500220,
248         "leadStatus": "new",
249         "devices": []
250       },
251       {
252         "leadId": 2500217,
253         "leadStatus": "new",
254         "devices": [
255           {
256             "deviceId": "FT30008470",
257             "deviceStatus": "new",
258             "statusDescription": "Mali değil"
259           }
260         ]
261       },
262       {
263         "leadId": 2500216,
264         "leadStatus": "new",
265         "devices": [
266           {
267             "deviceId": "FT40005024",
268             "deviceStatus": "new",
269             "statusDescription": "Mali değil"
270           }
271         ]
272       },
273       {
274         "leadId": 2500215,
275         "leadStatus": "new",
276         "devices": [
277           {
278             "deviceId": "FT40005018",
279             "deviceStatus": "new",
280             "statusDescription": "Mali değil"
281           }
282         ]
283       },
284       {
285         "leadId": 2500210,
286         "leadStatus": "new",
287         "devices": [
288           {
289             "deviceId": "FT40005031",
290             "deviceStatus": "new",
291             "statusDescription": "Mali değil"
292           }
293         ]
294       },
295       {
296         "leadId": 2500209,
297         "leadStatus": "new",
298         "devices": [
299           {
300             "deviceId": "FT30005262",
301             "deviceStatus": "new",
302             "statusDescription": "Mali değil"
303           }
304         ]
305       },
306       {
307         "leadId": 2500208,
308         "leadStatus": "new",
309         "devices": [
310           {
311             "deviceId": "FT30008847",
312             "deviceStatus": "new",
313             "statusDescription": "Mali değil"
314           }
315         ]
316       },
317       {
318         "leadId": 2500207,
319         "leadStatus": "new",
320         "devices": [
321           {
322             "deviceId": "FT30006275",
323             "deviceStatus": "new",
324             "statusDescription": "Mali değil"
325           }
326         ]
327       },
328       {
329         "leadId": 2500203,
330         "leadStatus": "new",
331         "devices": [
332           {
333             "deviceId": "FT30004588",
334             "deviceStatus": "new",
335             "statusDescription": "Mali değil"
336           }
337         ]
338       },
339       {
340         "leadId": 2500202,
341         "leadStatus": "new",
342         "devices": [
343           {
344             "deviceId": "FT30008430",
345             "deviceStatus": "new",
346             "statusDescription": "Mali değil"
347           }
348         ]
349       },
350       {
351         "leadId": 2500182,
352         "leadStatus": "new",
353         "devices": [
354           {
355             "deviceId": "FT30009540",
356             "deviceStatus": "new",
357             "statusDescription": "Mali değil"
358           }
359         ]
360       },
361       {
362         "leadId": 2500181,
363         "leadStatus": "new",
364         "devices": [
365           {
366             "deviceId": "FT30002493",
367             "deviceStatus": "new",
368             "statusDescription": "Mali değil"
369           }
370         ]
371       },
372       {
373         "leadId": 2500180,
374         "leadStatus": "new",
375         "devices": [
376           {
377             "deviceId": "FT40005016",
378             "deviceStatus": "new",
379             "statusDescription": "Mali değil"
380           }
381         ]
382       },
383       {
384         "leadId": 2500169,
385         "leadStatus": "new",
386         "devices": [
387           {
388             "deviceId": "FT40005021",
389             "deviceStatus": "new",
390             "statusDescription": "Mali değil"
391           }
392         ]
393       }
394     ]
395   },
396   "metadata": {
397     "timestamp": "2026-01-02T06:25:41.475824Z",
398     "instance": "/api/v1/leads"
399   }
400 }

VKN veya TCKN ile sipariş(leri) arar ve listeler. Tek parametre gönderilmelidir.

Query Parameters

Parametre	Tip
`taxId`	string

Response

Response Fields

Alan	Tip	Açıklama
`leads[].leadId`	int	Sipariş takip numarası
`leads[].leadStatus`	string	Ön Sipariş durum kodu
`leads[].devices`	array	Cihaz listesi
`leads[].devices[].deviceId`	string	ÖKC mali sicil numarası
`leads[].devices[].deviceStatus`	string	ÖKC durum kodu aşağıda
`leads[].devices[].terminalStatus`	string	ÖKC durum kodu aşağıda
`leads[].devices[].statusDescription`	string	ÖKC durum açıklaması

ÖKC Durum Kodları

Kod	Açıklama
`new`	Mali değil
`active`	Mali
`bank_active`	Terminal yüklü
`cancel`	Sipariş iptal
`onhold`	Geçici kapama
`transfer`	Devir
`inactive`	Hurda

Örnek Kullanım

GET /api/v1/leads?taxId=1234567890 - VKN ile arama
GET /api/v1/leads?taxId=12345678901 - TCKN ile arama
GET /api/v1/leads?taxId=12345678901&terminalId=27702109200 - +Terminal Id

# Search Leads - Sipariş Arama/Listeleme VKN veya TCKN ile sipariş(leri) arar ve listeler. Tek parametre gönderilmelidir. ## Query Parameters | Parametre | Tip | | --- | --- | | `taxId` | string | ## Response ## Response Fields | Alan | Tip | Açıklama | | --- | --- | --- | | `leads[].leadId` | int | Sipariş takip numarası | | `leads[].leadStatus` | string | Ön Sipariş durum kodu | | `leads[].devices` | array | Cihaz listesi | | `leads[].devices[].deviceId` | string | ÖKC mali sicil numarası | | `leads[].devices[].deviceStatus` | string | ÖKC durum kodu aşağıda | | `leads[].devices[].terminalStatus` | string | ÖKC durum kodu aşağıda | | `leads[].devices[].statusDescription` | string | ÖKC durum açıklaması | ## ÖKC Durum Kodları | Kod | Açıklama | | --- | --- | | `new` | Mali değil | | `active` | Mali | | `bank_active` | Terminal yüklü | | `cancel` | Sipariş iptal | | `onhold` | Geçici kapama | | `transfer` | Devir | | `inactive` | Hurda | ## Örnek Kullanım - `GET /api/v1/leads?taxId=1234567890` - VKN ile arama - `GET /api/v1/leads?taxId=12345678901` - TCKN ile arama - `GET /api/v1/leads?taxId=12345678901&terminalId=27702109200` - +Terminal Id

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

taxIdintegerOptional

Response

statusstring

dataobject

metadataobject

Errors

404

Not Found Error