Retrieve a Business User Event

GET

GET a Business User Event

You can retrieve any business user event you created using the POST Business User Events call.

Path parameters

eventIdstringRequired

Unique Business User Event Identifier

Response

This endpoint returns an object.

timestampdouble

Timestamp of the event

userIdstring

Transaction ID the event pertains to

eventIdstringOptional

Unique event ID

reasonstringOptional

Reason for the event or a state change

eventDescriptionstringOptional

Event description

updatedBusinessUserAttributesobjectOptional

Model for a business user - optional fields

executedRuleslist of objectsOptional

Model for list of executed rules

hitRuleslist of objectsOptional

Model for list of hit rules

riskScoreDetailsobjectOptional

Errors

GET

1 curl https://sandbox.api.flagright.com/events/business/user/eventId \
2      -H "x-api-key: <apiKey>"

1 {
2   "timestamp": 1.1,
3   "userId": "userId",
4   "eventId": "eventId",
5   "reason": "reason",
6   "eventDescription": "eventDescription",
7   "updatedBusinessUserAttributes": {
8     "activatedTimestamp": 1.1,
9     "userStateDetails": {
10       "reason": "reason",
11       "state": "UNACCEPTABLE"
12     },
13     "kycStatusDetails": {
14       "reason": "reason",
15       "status": "SUCCESSFUL"
16     },
17     "legalEntity": {
18       "companyGeneralDetails": {
19         "legalName": "Ozkan Hazelnut Export JSC",
20         "businessIndustry": [
21           "Farming"
22         ],
23         "mainProductsServicesSold": [
24           "Hazelnut"
25         ],
26         "tags": [
27           {
28             "key": "customKey",
29             "value": "customValue"
30           }
31         ]
32       },
33       "companyFinancialDetails": {
34         "expectedTransactionAmountPerMonth": {
35           "amountValue": 800,
36           "amountCurrency": "GBP"
37         },
38         "expectedTurnoverPerMonth": {
39           "amountValue": 8000,
40           "amountCurrency": "USD"
41         },
42         "tags": [
43           {
44             "key": "customKey",
45             "value": "customValue"
46           }
47         ]
48       },
49       "companyRegistrationDetails": {
50         "registrationIdentifier": "PSJ554342",
51         "registrationCountry": "DE",
52         "tags": [
53           {
54             "key": "customKey",
55             "value": "customValue"
56           }
57         ]
58       },
59       "reasonForAccountOpening": [
60         "string"
61       ],
62       "sourceOfFunds": [
63         "Earnings"
64       ],
65       "contactDetails": {
66         "addresses": [
67           {
68             "addressLines": [
69               "Klara-Franke Str 20"
70             ],
71             "postcode": "10557",
72             "city": "Berlin",
73             "state": "Berlin",
74             "country": "Germany",
75             "tags": [
76               {
77                 "key": "customKey",
78                 "value": "customValue"
79               }
80             ]
81           }
82         ]
83       }
84     },
85     "shareHolders": [
86       {
87         "generalDetails": {
88           "name": {
89             "firstName": "Baran",
90             "middleName": "Realblood",
91             "lastName": "Ozkan"
92           },
93           "dateOfBirth": "1991-01-01",
94           "countryOfResidence": "US",
95           "countryOfNationality": "DE"
96         },
97         "legalDocuments": [
98           {
99             "documentType": "passport",
100             "documentNumber": "Z9431P",
101             "documentIssuedDate": 1639939034000,
102             "documentExpirationDate": 1839939034000,
103             "documentIssuedCountry": "DE",
104             "tags": [
105               {
106                 "key": "customerType",
107                 "value": "wallet"
108               }
109             ],
110             "nameOnDocument": {
111               "firstName": "Baran",
112               "middleName": "Realblood",
113               "lastName": "Ozkan"
114             }
115           }
116         ],
117         "contactDetails": {
118           "emailIds": [
119             "baran@flagright.com"
120           ],
121           "contactNumbers": [
122             "+371 123132"
123           ],
124           "websites": [
125             "flagright.com"
126           ],
127           "addresses": [
128             {
129               "addressLines": [
130                 "Klara-Franke Str 20"
131               ],
132               "postcode": "10557",
133               "city": "Berlin",
134               "state": "Berlin",
135               "country": "Germany",
136               "tags": [
137                 {
138                   "key": "customKey",
139                   "value": "customValue"
140                 }
141               ]
142             }
143           ]
144         },
145         "tags": [
146           {
147             "key": "customKey",
148             "value": "customValue"
149           }
150         ]
151       }
152     ],
153     "directors": [
154       {
155         "generalDetails": {
156           "name": {
157             "firstName": "Baran",
158             "middleName": "Realblood",
159             "lastName": "Ozkan"
160           },
161           "dateOfBirth": "1991-01-01",
162           "countryOfResidence": "US",
163           "countryOfNationality": "DE"
164         },
165         "legalDocuments": [
166           {
167             "documentType": "passport",
168             "documentNumber": "Z9431P",
169             "documentIssuedDate": 1639939034000,
170             "documentExpirationDate": 1839939034000,
171             "documentIssuedCountry": "DE",
172             "tags": [
173               {
174                 "key": "customerType",
175                 "value": "wallet"
176               }
177             ],
178             "nameOnDocument": {
179               "firstName": "Baran",
180               "middleName": "Realblood",
181               "lastName": "Ozkan"
182             }
183           }
184         ],
185         "contactDetails": {
186           "emailIds": [
187             "baran@flagright.com"
188           ],
189           "contactNumbers": [
190             "+371 123132"
191           ],
192           "websites": [
193             "flagright.com"
194           ],
195           "addresses": [
196             {
197               "addressLines": [
198                 "Klara-Franke Str 20"
199               ],
200               "postcode": "10557",
201               "city": "Berlin",
202               "state": "Berlin",
203               "country": "Germany",
204               "tags": [
205                 {
206                   "key": "customKey",
207                   "value": "customValue"
208                 }
209               ]
210             }
211           ]
212         },
213         "tags": [
214           {
215             "key": "customKey",
216             "value": "customValue"
217           }
218         ]
219       }
220     ],
221     "transactionLimits": {
222       "maximumDailyTransactionLimit": {
223         "amountValue": 800,
224         "amountCurrency": "GBP"
225       },
226       "maximumWeeklyTransactionLimit": {
227         "amountValue": 800,
228         "amountCurrency": "GBP"
229       },
230       "maximumMonthlyTransactionLimit": {
231         "amountValue": 800,
232         "amountCurrency": "GBP"
233       },
234       "maximumQuarterlyTransactionLimit": {
235         "amountValue": 800,
236         "amountCurrency": "GBP"
237       },
238       "maximumTransactionLimit": {
239         "amountValue": 800,
240         "amountCurrency": "GBP"
241       },
242       "maximumYearlyTransactionLimit": {
243         "amountValue": 800,
244         "amountCurrency": "GBP"
245       }
246     },
247     "riskLevel": "VERY_HIGH",
248     "allowedPaymentMethods": [
249       "ACH"
250     ],
251     "linkedEntities": {
252       "parentUserId": "parentUserId"
253     },
254     "acquisitionChannel": "ORGANIC",
255     "mccDetails": {
256       "code": 1.1,
257       "description": "description"
258     },
259     "tags": [
260       {
261         "key": "customKey",
262         "value": "customValue"
263       }
264     ]
265   },
266   "executedRules": [
267     {
268       "ruleId": "R-1a",
269       "ruleInstanceId": "ruleInstanceId",
270       "ruleName": "Proof of funds for high value transactions",
271       "ruleDescription": "If a user makes a remittance transaction >= 1800 in EUR - ask for proof of funds",
272       "ruleAction": "BLOCK",
273       "ruleHit": true,
274       "vars": [
275         {
276           "value": {}
277         }
278       ],
279       "labels": [
280         "UNEXPECTED_BEHAVIOR"
281       ],
282       "nature": "AML",
283       "isShadow": true
284     }
285   ],
286   "hitRules": [
287     {
288       "ruleId": "R-1a",
289       "ruleInstanceId": "ruleInstanceId",
290       "ruleName": "Proof of funds for high value transactions",
291       "ruleDescription": "If a user makes a remittance transaction >= 1800 in EUR - ask for proof of funds",
292       "ruleAction": "BLOCK",
293       "labels": [
294         "UNEXPECTED_BEHAVIOR"
295       ],
296       "nature": "FRAUD",
297       "isShadow": true
298     }
299   ],
300   "riskScoreDetails": {
301     "kycRiskScore": 1.1,
302     "craRiskScore": 1.1,
303     "kycRiskLevel": "VERY_HIGH",
304     "craRiskLevel": "VERY_HIGH"
305   }
306 }

Built with

1	curl https://sandbox.api.flagright.com/events/business/user/eventId \
2	-H "x-api-key: <apiKey>"

1	{
2	"timestamp": 1.1,
3	"userId": "userId",
4	"eventId": "eventId",
5	"reason": "reason",
6	"eventDescription": "eventDescription",
7	"updatedBusinessUserAttributes": {
8	"activatedTimestamp": 1.1,
9	"userStateDetails": {
10	"reason": "reason",
11	"state": "UNACCEPTABLE"
12	},
13	"kycStatusDetails": {
14	"reason": "reason",
15	"status": "SUCCESSFUL"
16	},
17	"legalEntity": {
18	"companyGeneralDetails": {
19	"legalName": "Ozkan Hazelnut Export JSC",
20	"businessIndustry": [
21	"Farming"
22	],
23	"mainProductsServicesSold": [
24	"Hazelnut"
25	],
26	"tags": [
27	{
28	"key": "customKey",
29	"value": "customValue"
30	}
31	]
32	},
33	"companyFinancialDetails": {
34	"expectedTransactionAmountPerMonth": {
35	"amountValue": 800,
36	"amountCurrency": "GBP"
37	},
38	"expectedTurnoverPerMonth": {
39	"amountValue": 8000,
40	"amountCurrency": "USD"
41	},
42	"tags": [
43	{
44	"key": "customKey",
45	"value": "customValue"
46	}
47	]
48	},
49	"companyRegistrationDetails": {
50	"registrationIdentifier": "PSJ554342",
51	"registrationCountry": "DE",
52	"tags": [
53	{
54	"key": "customKey",
55	"value": "customValue"
56	}
57	]
58	},
59	"reasonForAccountOpening": [
60	"string"
61	],
62	"sourceOfFunds": [
63	"Earnings"
64	],
65	"contactDetails": {
66	"addresses": [
67	{
68	"addressLines": [
69	"Klara-Franke Str 20"
70	],
71	"postcode": "10557",
72	"city": "Berlin",
73	"state": "Berlin",
74	"country": "Germany",
75	"tags": [
76	{
77	"key": "customKey",
78	"value": "customValue"
79	}
80	]
81	}
82	]
83	}
84	},
85	"shareHolders": [
86	{
87	"generalDetails": {
88	"name": {
89	"firstName": "Baran",
90	"middleName": "Realblood",
91	"lastName": "Ozkan"
92	},
93	"dateOfBirth": "1991-01-01",
94	"countryOfResidence": "US",
95	"countryOfNationality": "DE"
96	},
97	"legalDocuments": [
98	{
99	"documentType": "passport",
100	"documentNumber": "Z9431P",
101	"documentIssuedDate": 1639939034000,
102	"documentExpirationDate": 1839939034000,
103	"documentIssuedCountry": "DE",
104	"tags": [
105	{
106	"key": "customerType",
107	"value": "wallet"
108	}
109	],
110	"nameOnDocument": {
111	"firstName": "Baran",
112	"middleName": "Realblood",
113	"lastName": "Ozkan"
114	}
115	}
116	],
117	"contactDetails": {
118	"emailIds": [
119	"baran@flagright.com"
120	],
121	"contactNumbers": [
122	"+371 123132"
123	],
124	"websites": [
125	"flagright.com"
126	],
127	"addresses": [
128	{
129	"addressLines": [
130	"Klara-Franke Str 20"
131	],
132	"postcode": "10557",
133	"city": "Berlin",
134	"state": "Berlin",
135	"country": "Germany",
136	"tags": [
137	{
138	"key": "customKey",
139	"value": "customValue"
140	}
141	]
142	}
143	]
144	},
145	"tags": [
146	{
147	"key": "customKey",
148	"value": "customValue"
149	}
150	]
151	}
152	],
153	"directors": [
154	{
155	"generalDetails": {
156	"name": {
157	"firstName": "Baran",
158	"middleName": "Realblood",
159	"lastName": "Ozkan"
160	},
161	"dateOfBirth": "1991-01-01",
162	"countryOfResidence": "US",
163	"countryOfNationality": "DE"
164	},
165	"legalDocuments": [
166	{
167	"documentType": "passport",
168	"documentNumber": "Z9431P",
169	"documentIssuedDate": 1639939034000,
170	"documentExpirationDate": 1839939034000,
171	"documentIssuedCountry": "DE",
172	"tags": [
173	{
174	"key": "customerType",
175	"value": "wallet"
176	}
177	],
178	"nameOnDocument": {
179	"firstName": "Baran",
180	"middleName": "Realblood",
181	"lastName": "Ozkan"
182	}
183	}
184	],
185	"contactDetails": {
186	"emailIds": [
187	"baran@flagright.com"
188	],
189	"contactNumbers": [
190	"+371 123132"
191	],
192	"websites": [
193	"flagright.com"
194	],
195	"addresses": [
196	{
197	"addressLines": [
198	"Klara-Franke Str 20"
199	],
200	"postcode": "10557",
201	"city": "Berlin",
202	"state": "Berlin",
203	"country": "Germany",
204	"tags": [
205	{
206	"key": "customKey",
207	"value": "customValue"
208	}
209	]
210	}
211	]
212	},
213	"tags": [
214	{
215	"key": "customKey",
216	"value": "customValue"
217	}
218	]
219	}
220	],
221	"transactionLimits": {
222	"maximumDailyTransactionLimit": {
223	"amountValue": 800,
224	"amountCurrency": "GBP"
225	},
226	"maximumWeeklyTransactionLimit": {
227	"amountValue": 800,
228	"amountCurrency": "GBP"
229	},
230	"maximumMonthlyTransactionLimit": {
231	"amountValue": 800,
232	"amountCurrency": "GBP"
233	},
234	"maximumQuarterlyTransactionLimit": {
235	"amountValue": 800,
236	"amountCurrency": "GBP"
237	},
238	"maximumTransactionLimit": {
239	"amountValue": 800,
240	"amountCurrency": "GBP"
241	},
242	"maximumYearlyTransactionLimit": {
243	"amountValue": 800,
244	"amountCurrency": "GBP"
245	}
246	},
247	"riskLevel": "VERY_HIGH",
248	"allowedPaymentMethods": [
249	"ACH"
250	],
251	"linkedEntities": {
252	"parentUserId": "parentUserId"
253	},
254	"acquisitionChannel": "ORGANIC",
255	"mccDetails": {
256	"code": 1.1,
257	"description": "description"
258	},
259	"tags": [
260	{
261	"key": "customKey",
262	"value": "customValue"
263	}
264	]
265	},
266	"executedRules": [
267	{
268	"ruleId": "R-1a",
269	"ruleInstanceId": "ruleInstanceId",
270	"ruleName": "Proof of funds for high value transactions",
271	"ruleDescription": "If a user makes a remittance transaction >= 1800 in EUR - ask for proof of funds",
272	"ruleAction": "BLOCK",
273	"ruleHit": true,
274	"vars": [
275	{
276	"value": {}
277	}
278	],
279	"labels": [
280	"UNEXPECTED_BEHAVIOR"
281	],
282	"nature": "AML",
283	"isShadow": true
284	}
285	],
286	"hitRules": [
287	{
288	"ruleId": "R-1a",
289	"ruleInstanceId": "ruleInstanceId",
290	"ruleName": "Proof of funds for high value transactions",
291	"ruleDescription": "If a user makes a remittance transaction >= 1800 in EUR - ask for proof of funds",
292	"ruleAction": "BLOCK",
293	"labels": [
294	"UNEXPECTED_BEHAVIOR"
295	],
296	"nature": "FRAUD",
297	"isShadow": true
298	}
299	],
300	"riskScoreDetails": {
301	"kycRiskScore": 1.1,
302	"craRiskScore": 1.1,
303	"kycRiskLevel": "VERY_HIGH",
304	"craRiskLevel": "VERY_HIGH"
305	}
306	}