Users - Search

GET

/users/search

GET

/management/users/search

1 import requests
2 
3 url = "https://sandbox.api.flagright.com/management/users/search"
4 
5 headers = {"x-api-key": "<apiKey>"}
6 
7 response = requests.get(url, headers=headers)
8 
9 print(response.json())

Try it

200Retrieved

1 {
2   "items": [
3     {
4       "userId": "string",
5       "createdTimestamp": 2220000000000,
6       "activatedTimestamp": 2220000000000,
7       "userDetails": {
8         "name": {
9           "firstName": "string",
10           "middleName": "string",
11           "lastName": "string"
12         },
13         "dateOfBirth": "string",
14         "userCategory": "string",
15         "countryOfResidence": "AF",
16         "countryOfTaxResidence": "AF",
17         "countryOfNationality": "AF",
18         "gender": "M",
19         "maritalStatus": "DIVORCED",
20         "placeOfBirth": {
21           "city": "string",
22           "state": "string",
23           "country": "AF"
24         },
25         "alias": [
26           "string"
27         ]
28       },
29       "userStateDetails": {
30         "reason": "string",
31         "state": "UNACCEPTABLE"
32       },
33       "kycStatusDetails": {
34         "reason": "string",
35         "status": "SUCCESSFUL"
36       },
37       "eoddDate": 1.1,
38       "employmentStatus": "UNEMPLOYED",
39       "occupation": "string",
40       "legalDocuments": [
41         {
42           "documentType": "string",
43           "documentNumber": "string",
44           "documentIssuedDate": 1.1,
45           "documentExpirationDate": 1.1,
46           "documentIssuedCountry": "AF",
47           "tags": [
48             {
49               "key": "string",
50               "value": "string",
51               "isTimestamp": true
52             }
53           ],
54           "nameOnDocument": {
55             "firstName": "string",
56             "middleName": "string",
57             "lastName": "string"
58           }
59         }
60       ],
61       "contactDetails": {
62         "emailIds": [
63           "string"
64         ],
65         "contactNumbers": [
66           "string"
67         ],
68         "faxNumbers": [
69           "string"
70         ],
71         "websites": [
72           "string"
73         ],
74         "addresses": [
75           {
76             "addressLines": [
77               "string"
78             ],
79             "postcode": "string",
80             "city": "string",
81             "state": "string",
82             "country": "string",
83             "addressType": "string",
84             "tags": [
85               {
86                 "key": "string",
87                 "value": "string",
88                 "isTimestamp": true
89               }
90             ]
91           }
92         ],
93         "name": {
94           "firstName": "string",
95           "middleName": "string",
96           "lastName": "string"
97         },
98         "tags": [
99           {
100             "key": "string",
101             "value": "string",
102             "isTimestamp": true
103           }
104         ]
105       },
106       "employmentDetails": {
107         "employmentSector": "string",
108         "employerName": "string",
109         "businessIndustry": [
110           "string"
111         ]
112       },
113       "transactionLimits": {
114         "maximumDailyTransactionLimit": {
115           "amountValue": 1.1,
116           "amountCurrency": "1INCH"
117         },
118         "maximumWeeklyTransactionLimit": {
119           "amountValue": 1.1,
120           "amountCurrency": "1INCH"
121         },
122         "maximumMonthlyTransactionLimit": {
123           "amountValue": 1.1,
124           "amountCurrency": "1INCH"
125         },
126         "maximumQuarterlyTransactionLimit": {
127           "amountValue": 1.1,
128           "amountCurrency": "1INCH"
129         },
130         "maximumTransactionLimit": {
131           "amountValue": 1.1,
132           "amountCurrency": "1INCH"
133         },
134         "maximumYearlyTransactionLimit": {
135           "amountValue": 1.1,
136           "amountCurrency": "1INCH"
137         },
138         "paymentMethodLimits": {
139           "ACH": {
140             "transactionCountLimit": {
141               "day": 1.1,
142               "week": 1.1,
143               "month": 1.1,
144               "year": 1.1
145             },
146             "transactionAmountLimit": {
147               "day": {
148                 "amountValue": 1.1,
149                 "amountCurrency": "1INCH"
150               },
151               "week": {
152                 "amountValue": 1.1,
153                 "amountCurrency": "1INCH"
154               },
155               "month": {
156                 "amountValue": 1.1,
157                 "amountCurrency": "1INCH"
158               },
159               "year": {
160                 "amountValue": 1.1,
161                 "amountCurrency": "1INCH"
162               }
163             },
164             "averageTransactionAmountLimit": {
165               "day": {
166                 "amountValue": 1.1,
167                 "amountCurrency": "1INCH"
168               },
169               "week": {
170                 "amountValue": 1.1,
171                 "amountCurrency": "1INCH"
172               },
173               "month": {
174                 "amountValue": 1.1,
175                 "amountCurrency": "1INCH"
176               },
177               "year": {
178                 "amountValue": 1.1,
179                 "amountCurrency": "1INCH"
180               }
181             }
182           },
183           "CARD": {
184             "transactionCountLimit": {
185               "day": 1.1,
186               "week": 1.1,
187               "month": 1.1,
188               "year": 1.1
189             },
190             "transactionAmountLimit": {
191               "day": {
192                 "amountValue": 1.1,
193                 "amountCurrency": "1INCH"
194               },
195               "week": {
196                 "amountValue": 1.1,
197                 "amountCurrency": "1INCH"
198               },
199               "month": {
200                 "amountValue": 1.1,
201                 "amountCurrency": "1INCH"
202               },
203               "year": {
204                 "amountValue": 1.1,
205                 "amountCurrency": "1INCH"
206               }
207             },
208             "averageTransactionAmountLimit": {
209               "day": {
210                 "amountValue": 1.1,
211                 "amountCurrency": "1INCH"
212               },
213               "week": {
214                 "amountValue": 1.1,
215                 "amountCurrency": "1INCH"
216               },
217               "month": {
218                 "amountValue": 1.1,
219                 "amountCurrency": "1INCH"
220               },
221               "year": {
222                 "amountValue": 1.1,
223                 "amountCurrency": "1INCH"
224               }
225             }
226           },
227           "IBAN": {
228             "transactionCountLimit": {
229               "day": 1.1,
230               "week": 1.1,
231               "month": 1.1,
232               "year": 1.1
233             },
234             "transactionAmountLimit": {
235               "day": {
236                 "amountValue": 1.1,
237                 "amountCurrency": "1INCH"
238               },
239               "week": {
240                 "amountValue": 1.1,
241                 "amountCurrency": "1INCH"
242               },
243               "month": {
244                 "amountValue": 1.1,
245                 "amountCurrency": "1INCH"
246               },
247               "year": {
248                 "amountValue": 1.1,
249                 "amountCurrency": "1INCH"
250               }
251             },
252             "averageTransactionAmountLimit": {
253               "day": {
254                 "amountValue": 1.1,
255                 "amountCurrency": "1INCH"
256               },
257               "week": {
258                 "amountValue": 1.1,
259                 "amountCurrency": "1INCH"
260               },
261               "month": {
262                 "amountValue": 1.1,
263                 "amountCurrency": "1INCH"
264               },
265               "year": {
266                 "amountValue": 1.1,
267                 "amountCurrency": "1INCH"
268               }
269             }
270           },
271           "UPI": {
272             "transactionCountLimit": {
273               "day": 1.1,
274               "week": 1.1,
275               "month": 1.1,
276               "year": 1.1
277             },
278             "transactionAmountLimit": {
279               "day": {
280                 "amountValue": 1.1,
281                 "amountCurrency": "1INCH"
282               },
283               "week": {
284                 "amountValue": 1.1,
285                 "amountCurrency": "1INCH"
286               },
287               "month": {
288                 "amountValue": 1.1,
289                 "amountCurrency": "1INCH"
290               },
291               "year": {
292                 "amountValue": 1.1,
293                 "amountCurrency": "1INCH"
294               }
295             },
296             "averageTransactionAmountLimit": {
297               "day": {
298                 "amountValue": 1.1,
299                 "amountCurrency": "1INCH"
300               },
301               "week": {
302                 "amountValue": 1.1,
303                 "amountCurrency": "1INCH"
304               },
305               "month": {
306                 "amountValue": 1.1,
307                 "amountCurrency": "1INCH"
308               },
309               "year": {
310                 "amountValue": 1.1,
311                 "amountCurrency": "1INCH"
312               }
313             }
314           },
315           "GENERIC_BANK_ACCOUNT": {
316             "transactionCountLimit": {
317               "day": 1.1,
318               "week": 1.1,
319               "month": 1.1,
320               "year": 1.1
321             },
322             "transactionAmountLimit": {
323               "day": {
324                 "amountValue": 1.1,
325                 "amountCurrency": "1INCH"
326               },
327               "week": {
328                 "amountValue": 1.1,
329                 "amountCurrency": "1INCH"
330               },
331               "month": {
332                 "amountValue": 1.1,
333                 "amountCurrency": "1INCH"
334               },
335               "year": {
336                 "amountValue": 1.1,
337                 "amountCurrency": "1INCH"
338               }
339             },
340             "averageTransactionAmountLimit": {
341               "day": {
342                 "amountValue": 1.1,
343                 "amountCurrency": "1INCH"
344               },
345               "week": {
346                 "amountValue": 1.1,
347                 "amountCurrency": "1INCH"
348               },
349               "month": {
350                 "amountValue": 1.1,
351                 "amountCurrency": "1INCH"
352               },
353               "year": {
354                 "amountValue": 1.1,
355                 "amountCurrency": "1INCH"
356               }
357             }
358           },
359           "MPESA": {
360             "transactionCountLimit": {
361               "day": 1.1,
362               "week": 1.1,
363               "month": 1.1,
364               "year": 1.1
365             },
366             "transactionAmountLimit": {
367               "day": {
368                 "amountValue": 1.1,
369                 "amountCurrency": "1INCH"
370               },
371               "week": {
372                 "amountValue": 1.1,
373                 "amountCurrency": "1INCH"
374               },
375               "month": {
376                 "amountValue": 1.1,
377                 "amountCurrency": "1INCH"
378               },
379               "year": {
380                 "amountValue": 1.1,
381                 "amountCurrency": "1INCH"
382               }
383             },
384             "averageTransactionAmountLimit": {
385               "day": {
386                 "amountValue": 1.1,
387                 "amountCurrency": "1INCH"
388               },
389               "week": {
390                 "amountValue": 1.1,
391                 "amountCurrency": "1INCH"
392               },
393               "month": {
394                 "amountValue": 1.1,
395                 "amountCurrency": "1INCH"
396               },
397               "year": {
398                 "amountValue": 1.1,
399                 "amountCurrency": "1INCH"
400               }
401             }
402           },
403           "SWIFT": {
404             "transactionCountLimit": {
405               "day": 1.1,
406               "week": 1.1,
407               "month": 1.1,
408               "year": 1.1
409             },
410             "transactionAmountLimit": {
411               "day": {
412                 "amountValue": 1.1,
413                 "amountCurrency": "1INCH"
414               },
415               "week": {
416                 "amountValue": 1.1,
417                 "amountCurrency": "1INCH"
418               },
419               "month": {
420                 "amountValue": 1.1,
421                 "amountCurrency": "1INCH"
422               },
423               "year": {
424                 "amountValue": 1.1,
425                 "amountCurrency": "1INCH"
426               }
427             },
428             "averageTransactionAmountLimit": {
429               "day": {
430                 "amountValue": 1.1,
431                 "amountCurrency": "1INCH"
432               },
433               "week": {
434                 "amountValue": 1.1,
435                 "amountCurrency": "1INCH"
436               },
437               "month": {
438                 "amountValue": 1.1,
439                 "amountCurrency": "1INCH"
440               },
441               "year": {
442                 "amountValue": 1.1,
443                 "amountCurrency": "1INCH"
444               }
445             }
446           },
447           "WALLET": {
448             "transactionCountLimit": {
449               "day": 1.1,
450               "week": 1.1,
451               "month": 1.1,
452               "year": 1.1
453             },
454             "transactionAmountLimit": {
455               "day": {
456                 "amountValue": 1.1,
457                 "amountCurrency": "1INCH"
458               },
459               "week": {
460                 "amountValue": 1.1,
461                 "amountCurrency": "1INCH"
462               },
463               "month": {
464                 "amountValue": 1.1,
465                 "amountCurrency": "1INCH"
466               },
467               "year": {
468                 "amountValue": 1.1,
469                 "amountCurrency": "1INCH"
470               }
471             },
472             "averageTransactionAmountLimit": {
473               "day": {
474                 "amountValue": 1.1,
475                 "amountCurrency": "1INCH"
476               },
477               "week": {
478                 "amountValue": 1.1,
479                 "amountCurrency": "1INCH"
480               },
481               "month": {
482                 "amountValue": 1.1,
483                 "amountCurrency": "1INCH"
484               },
485               "year": {
486                 "amountValue": 1.1,
487                 "amountCurrency": "1INCH"
488               }
489             }
490           },
491           "CHECK": {
492             "transactionCountLimit": {
493               "day": 1.1,
494               "week": 1.1,
495               "month": 1.1,
496               "year": 1.1
497             },
498             "transactionAmountLimit": {
499               "day": {
500                 "amountValue": 1.1,
501                 "amountCurrency": "1INCH"
502               },
503               "week": {
504                 "amountValue": 1.1,
505                 "amountCurrency": "1INCH"
506               },
507               "month": {
508                 "amountValue": 1.1,
509                 "amountCurrency": "1INCH"
510               },
511               "year": {
512                 "amountValue": 1.1,
513                 "amountCurrency": "1INCH"
514               }
515             },
516             "averageTransactionAmountLimit": {
517               "day": {
518                 "amountValue": 1.1,
519                 "amountCurrency": "1INCH"
520               },
521               "week": {
522                 "amountValue": 1.1,
523                 "amountCurrency": "1INCH"
524               },
525               "month": {
526                 "amountValue": 1.1,
527                 "amountCurrency": "1INCH"
528               },
529               "year": {
530                 "amountValue": 1.1,
531                 "amountCurrency": "1INCH"
532               }
533             }
534           },
535           "CASH": {
536             "transactionCountLimit": {
537               "day": 1.1,
538               "week": 1.1,
539               "month": 1.1,
540               "year": 1.1
541             },
542             "transactionAmountLimit": {
543               "day": {
544                 "amountValue": 1.1,
545                 "amountCurrency": "1INCH"
546               },
547               "week": {
548                 "amountValue": 1.1,
549                 "amountCurrency": "1INCH"
550               },
551               "month": {
552                 "amountValue": 1.1,
553                 "amountCurrency": "1INCH"
554               },
555               "year": {
556                 "amountValue": 1.1,
557                 "amountCurrency": "1INCH"
558               }
559             },
560             "averageTransactionAmountLimit": {
561               "day": {
562                 "amountValue": 1.1,
563                 "amountCurrency": "1INCH"
564               },
565               "week": {
566                 "amountValue": 1.1,
567                 "amountCurrency": "1INCH"
568               },
569               "month": {
570                 "amountValue": 1.1,
571                 "amountCurrency": "1INCH"
572               },
573               "year": {
574                 "amountValue": 1.1,
575                 "amountCurrency": "1INCH"
576               }
577             }
578           },
579           "NPP": {
580             "transactionCountLimit": {
581               "day": 1.1,
582               "week": 1.1,
583               "month": 1.1,
584               "year": 1.1
585             },
586             "transactionAmountLimit": {
587               "day": {
588                 "amountValue": 1.1,
589                 "amountCurrency": "1INCH"
590               },
591               "week": {
592                 "amountValue": 1.1,
593                 "amountCurrency": "1INCH"
594               },
595               "month": {
596                 "amountValue": 1.1,
597                 "amountCurrency": "1INCH"
598               },
599               "year": {
600                 "amountValue": 1.1,
601                 "amountCurrency": "1INCH"
602               }
603             },
604             "averageTransactionAmountLimit": {
605               "day": {
606                 "amountValue": 1.1,
607                 "amountCurrency": "1INCH"
608               },
609               "week": {
610                 "amountValue": 1.1,
611                 "amountCurrency": "1INCH"
612               },
613               "month": {
614                 "amountValue": 1.1,
615                 "amountCurrency": "1INCH"
616               },
617               "year": {
618                 "amountValue": 1.1,
619                 "amountCurrency": "1INCH"
620               }
621             }
622           }
623         }
624       },
625       "expectedIncome": {
626         "dailyExpectedIncome": {
627           "amountValue": 1.1,
628           "amountCurrency": "1INCH"
629         },
630         "weeklyExpectedIncome": {
631           "amountValue": 1.1,
632           "amountCurrency": "1INCH"
633         },
634         "monthlyExpectedIncome": {
635           "amountValue": 1.1,
636           "amountCurrency": "1INCH"
637         },
638         "quarterlyExpectedIncome": {
639           "amountValue": 1.1,
640           "amountCurrency": "1INCH"
641         },
642         "yearlyExpectedIncome": {
643           "amountValue": 1.1,
644           "amountCurrency": "1INCH"
645         }
646       },
647       "riskLevel": "VERY_HIGH",
648       "kycRiskLevel": "VERY_HIGH",
649       "acquisitionChannel": "ORGANIC",
650       "reasonForAccountOpening": [
651         "string"
652       ],
653       "sourceOfFunds": [
654         "Earnings"
655       ],
656       "userSegment": "RETAIL",
657       "pepStatus": [
658         {
659           "isPepHit": true,
660           "pepCountry": "AF",
661           "pepRank": "LEVEL_1",
662           "category": "string"
663         }
664       ],
665       "sanctionsStatus": true,
666       "adverseMediaStatus": true,
667       "corporateEntities": [
668         {
669           "legalName": "string"
670         }
671       ],
672       "linkedEntities": {
673         "parentUserId": "string"
674       },
675       "savedPaymentDetails": [
676         {
677           "method": "CARD",
678           "counterpartyType": "INDIVIDUAL",
679           "cardFingerprint": "string",
680           "emailId": "string",
681           "cardStatus": "ACTIVE",
682           "cardIssuedCountry": "AF",
683           "transactionReferenceField": "string",
684           "3dsDone": true,
685           "nameOnCard": {
686             "firstName": "string",
687             "middleName": "string",
688             "lastName": "string"
689           },
690           "cardExpiry": {
691             "month": 1.1,
692             "year": 1.1
693           },
694           "posDetails": {
695             "entryMode": "0"
696           },
697           "cardLast4Digits": "string",
698           "cardBrand": "VISA",
699           "cardFunding": "CREDIT",
700           "cardAuthenticated": true,
701           "cardTokenized": true,
702           "cardPresent": true,
703           "paymentChannel": "string",
704           "cardType": "VIRTUAL",
705           "cardBalance": {
706             "amountValue": 1.1,
707             "amountCurrency": "1INCH"
708           },
709           "merchantDetails": {
710             "id": "string",
711             "name": "string",
712             "category": "string",
713             "MCC": "string",
714             "city": "string",
715             "country": "AF",
716             "state": "string",
717             "postCode": "string"
718           },
719           "networkProviderRiskScore": 1.1,
720           "address": {
721             "addressLines": [
722               "string"
723             ],
724             "postcode": "string",
725             "city": "string",
726             "state": "string",
727             "country": "string",
728             "addressType": "string",
729             "tags": [
730               {
731                 "key": "string",
732                 "value": "string",
733                 "isTimestamp": true
734               }
735             ]
736           },
737           "countryOfNationality": "AF",
738           "countryOfResidence": "AF",
739           "bankAddress": {
740             "addressLines": [
741               "string"
742             ],
743             "postcode": "string",
744             "city": "string",
745             "state": "string",
746             "country": "string",
747             "addressType": "string",
748             "tags": [
749               {
750                 "key": "string",
751                 "value": "string",
752                 "isTimestamp": true
753               }
754             ]
755           },
756           "tags": [
757             {
758               "key": "string",
759               "value": "string",
760               "isTimestamp": true
761             }
762           ]
763         }
764       ],
765       "tags": [
766         {
767           "key": "string",
768           "value": "string",
769           "isTimestamp": true,
770           "isEditable": true
771         }
772       ],
773       "attachments": [
774         {
775           "id": "string",
776           "comment": "string",
777           "files": [
778             {
779               "s3Key": "string",
780               "bucket": "string",
781               "filename": "string",
782               "size": 1.1,
783               "downloadLink": "string",
784               "aiSummary": "string"
785             }
786           ],
787           "userId": "string",
788           "createdAt": 1.1,
789           "deletedAt": 1.1,
790           "tags": [
791             "string"
792           ]
793         }
794       ],
795       "metaData": {
796         "batteryLevel": 1.1,
797         "deviceLatitude": 1.1,
798         "deviceLongitude": 1.1,
799         "ipAddress": "string",
800         "ipCountry": "AF",
801         "deviceIdentifier": "string",
802         "vpnUsed": true,
803         "operatingSystem": "string",
804         "deviceMaker": "string",
805         "deviceModel": "string",
806         "deviceYear": "string",
807         "appVersion": "string"
808       },
809       "jurisdiction": "string",
810       "productsEnabled": [
811         {
812           "productName": "string"
813         }
814       ]
815     }
816   ],
817   "hasNext": true,
818   "hasPrev": true,
819   "next": "string",
820   "prev": "string",
821   "count": 1,
822   "pageSize": 1,
823   "last": "string"
824 }

Users Search

GET /users/search endpoint retrieves a list of users matching the specified search criteria.

Authentication

x-api-keystring

API Key authentication via header

Query parameters

namestringOptional

emailstringOptional

startstringOptional

pageSizeintegerOptional1-100

sortOrderenumOptional

Allowed values:

sortByenumOptional

Allowed values:

Response

itemslist of objects or null

hasNextboolean or null

hasPrevboolean or null

nextstring or null

prevstring or null

countinteger or null

pageSizeinteger or null

laststring or null

Users Search

Authentication

Query parameters

Response

Errors