Organizations Lookup

POST

Lookup for a given business name or business number across international business registries.

The lookup will return a list of matching companies that you can then potentially query using the business profile query.

Each lookup result will have a organizationToken that you use to retrieve the specific company details using the profile or ownership function.

Note: This process will not save any details from the lookup results.

Headers

X-Frankie-CustomerIDstringRequired

Your Customer ID provided by FrankieOne

X-Frankie-CustomerChildIDstringOptional

Your Customer Child ID provided by FrankieOne

X-Frankie-ChannelstringOptional

Open string that can be used to define the “channel” the request comes in from. It can potentially be used in routing and risk calculations upon request. Default values that can be used are: api portal smartui Any alphanumeric string is supported though. Anything over 64 characters will be truncated.

Request

This endpoint expects an object.

regionobjectRequired

organizationNamestringOptional

The name of the organization that we are looking up for

organizationNumberobjectOptional

Response

requestIdstring

The unique request ID for the API call made.

matchedOrganizationslist of objects

An array of organizations matching the provided lookup criteria

queryDetailsobject

Contains the criteria used to lookup for organizations.

POST

1 curl -X POST https://api.frankie.one/v2.1/organizations/lookup \
2      -H "X-Frankie-CustomerID: 12345678-1234-1234-1234-123456789012" \
3      -H "X-Frankie-CustomerChildID: 87654321-4321-4321-4321-210987654321" \
4      -H "api_key: <apiKey>" \
5      -H "Content-Type: application/json" \
6      -d '{
7   "region": {
8     "country": "country"
9   }
10 }'

200ExampleLookup

1 {
2   "requestId": "01J949482NZT359YHTT07X6GBT",
3   "matchedOrganizations": [
4     {
5       "country": "string",
6       "addresses": [
7         {
8           "country": "AUS",
9           "addressId": "b39ec506-712e-47b6-a0f5-50d9e5fb34e9",
10           "buildingName": "buildingName",
11           "careOf": "careOf",
12           "district": "district",
13           "locality": "NEDLANDS",
14           "longForm": "longForm",
15           "neighborhood": "neighborhood",
16           "postalCode": "6009",
17           "sourceId": "d37e3af7-8c3b-48c7-8d50-3ec07d4375f9",
18           "status": "CURRENT",
19           "streetName": "141 BROADWAY",
20           "streetNumber": "streetNumber",
21           "streetType": "streetType",
22           "subdivision": "subdivision",
23           "type": "BUSINESS",
24           "typeDescription": "typeDescription",
25           "unitNumber": "LEVEL 1",
26           "unstructuredLongForm": "unstructuredLongForm",
27           "validFrom": {
28             "day": "07",
29             "month": "08",
30             "normalized": "1990-03-31",
31             "type": "BUDDHIST",
32             "unstructured": "2006-08-07",
33             "year": "2006"
34           },
35           "validTo": {
36             "day": "27",
37             "month": "03",
38             "normalized": "1990-03-31",
39             "type": "BUDDHIST",
40             "unstructured": "12 Rajab 1445 AH",
41             "year": "1990"
42           }
43         }
44       ],
45       "alternateNames": [
46         {
47           "name": "name",
48           "type": "type",
49           "validFrom": {
50             "day": "27",
51             "month": "03",
52             "normalized": "1990-03-31",
53             "type": "BUDDHIST",
54             "unstructured": "12 Rajab 1445 AH",
55             "year": "1990"
56           },
57           "validTo": {
58             "day": "27",
59             "month": "03",
60             "normalized": "1990-03-31",
61             "type": "BUDDHIST",
62             "unstructured": "12 Rajab 1445 AH",
63             "year": "1990"
64           },
65           "sourceId": "sourceId"
66         }
67       ],
68       "emailAddresses": [
69         {
70           "emailAddressId": "aa385f64-5717-4562-b3fc-2c963f66af21",
71           "type": "OTHER",
72           "sourceId": "31dd15f64-5717-4562-b3fc-2c963f66234d",
73           "email": "leonardo_dc@outlook.com",
74           "isPreferred": true,
75           "linkedAddresses": [
76             {
77               "addressId": "adc215f64-5717-4562-b3fc-2c963f66222a"
78             }
79           ]
80         }
81       ],
82       "name": {
83         "name": "name",
84         "type": "type",
85         "validFrom": {
86           "day": "27",
87           "month": "03",
88           "normalized": "1990-03-31",
89           "type": "BUDDHIST",
90           "unstructured": "12 Rajab 1445 AH",
91           "year": "1990"
92         },
93         "validTo": {
94           "day": "27",
95           "month": "03",
96           "normalized": "1990-03-31",
97           "type": "BUDDHIST",
98           "unstructured": "12 Rajab 1445 AH",
99           "year": "1990"
100         },
101         "sourceId": "sourceId"
102       },
103       "organizationToken": "string",
104       "phoneNumbers": [
105         {
106           "phoneNumberId": "ad165f64-5717-4562-b3fc-2c963f66bfa9",
107           "isPreferred": true,
108           "type": "OTHER",
109           "sourceId": "14fd5f64-5717-4562-b3fc-2c963f66ba34",
110           "country": "AUS",
111           "number": "0426192340",
112           "linkedAddresses": [
113             {
114               "addressId": "fa335f64-5717-4562-b3fc-2c963f66cf41"
115             }
116           ],
117           "unstructuredLongForm": "unstructuredLongForm"
118         }
119       ],
120       "registrationDetails": [
121         {
122           "registrationNumber": "11000016722",
123           "class": {
124             "code": "LMSH",
125             "description": "Limited By Shares",
126             "sourceId": "d37e3af7-8c3b-48c7-8d50-3ec07d4375f9"
127           },
128           "extractedDate": {
129             "day": "07",
130             "month": "08",
131             "normalized": "2006-08-07",
132             "type": "BUDDHIST",
133             "unstructured": "2006-08-07",
134             "year": "2006"
135           },
136           "foundationDate": {
137             "day": "27",
138             "month": "03",
139             "normalized": "1990-03-31",
140             "type": "BUDDHIST",
141             "unstructured": "12 Rajab 1445 AH",
142             "year": "1990"
143           },
144           "isCurrent": true,
145           "isSuppressed": true,
146           "registeredCountry": "registeredCountry",
147           "registeredDate": {
148             "day": "07",
149             "month": "08",
150             "normalized": "2006-08-07",
151             "type": "BUDDHIST",
152             "unstructured": "2006-08-07",
153             "year": "2006"
154           },
155           "registeredName": {
156             "name": "name",
157             "type": "type",
158             "validFrom": {
159               "day": "27",
160               "month": "03",
161               "normalized": "1990-03-31",
162               "type": "BUDDHIST",
163               "unstructured": "12 Rajab 1445 AH",
164               "year": "1990"
165             },
166             "validTo": {
167               "day": "27",
168               "month": "03",
169               "normalized": "1990-03-31",
170               "type": "BUDDHIST",
171               "unstructured": "12 Rajab 1445 AH",
172               "year": "1990"
173             },
174             "sourceId": "sourceId"
175           },
176           "registeredSubdivision": "registeredSubdivision",
177           "registrationNumberDescription": "Australian Business Number",
178           "registrationNumberType": "ABN",
179           "registrationStatus": {
180             "normalized": {
181               "code": "code",
182               "description": "description"
183             },
184             "unstructured": {
185               "code": "code",
186               "description": "description"
187             },
188             "sourceId": "sourceId"
189           },
190           "registry": "ABR",
191           "registryDescription": "registryDescription",
192           "reviewDate": {
193             "day": "27",
194             "month": "03",
195             "normalized": "1990-03-31",
196             "type": "BUDDHIST",
197             "unstructured": "12 Rajab 1445 AH",
198             "year": "1990"
199           },
200           "sourceId": "sourceId",
201           "status": {
202             "normalized": {
203               "code": "ACTV",
204               "description": "ACTIVE"
205             },
206             "unstructured": {
207               "code": "REGD",
208               "description": "Registered"
209             },
210             "sourceId": "d37e3af7-8c3b-48c7-8d50-3ec07d4375f9"
211           },
212           "subClass": {
213             "code": "code",
214             "description": "description",
215             "sourceId": "sourceId"
216           },
217           "subType": {
218             "code": "code",
219             "description": "description",
220             "sourceId": "sourceId"
221           },
222           "type": {
223             "code": "code",
224             "description": "description",
225             "sourceId": "sourceId"
226           },
227           "updatedDate": {
228             "day": "07",
229             "month": "08",
230             "normalized": "2006-08-07",
231             "type": "BUDDHIST",
232             "unstructured": "2006-08-07",
233             "year": "2006"
234           },
235           "validFrom": {
236             "day": "27",
237             "month": "03",
238             "normalized": "1990-03-31",
239             "type": "BUDDHIST",
240             "unstructured": "12 Rajab 1445 AH",
241             "year": "1990"
242           },
243           "validTo": {
244             "day": "27",
245             "month": "03",
246             "normalized": "1990-03-31",
247             "type": "BUDDHIST",
248             "unstructured": "12 Rajab 1445 AH",
249             "year": "1990"
250           }
251         }
252       ],
253       "status": {
254         "normalized": {
255           "code": "code",
256           "description": "description"
257         },
258         "unstructured": {
259           "code": "code",
260           "description": "description"
261         },
262         "sourceId": "sourceId"
263       },
264       "subdivision": "string",
265       "type": {
266         "code": "code",
267         "description": "description"
268       },
269       "websiteUrls": [
270         {
271           "websiteUrl": "websiteUrl",
272           "sourceId": "sourceId"
273         }
274       ]
275     }
276   ],
277   "queryDetails": {
278     "region": {
279       "country": "AUS",
280       "subdivision": "subdivision"
281     },
282     "organizationName": "INSURANCE AUSTRALIA LIMITED",
283     "organizationNumber": {
284       "registrationNumber": "11000016722",
285       "registryCode": "ABN"
286     }
287   }
288 }

Organization Profile

Up Next

Built with

1	curl -X POST https://api.frankie.one/v2.1/organizations/lookup \
2	-H "X-Frankie-CustomerID: 12345678-1234-1234-1234-123456789012" \
3	-H "X-Frankie-CustomerChildID: 87654321-4321-4321-4321-210987654321" \
4	-H "api_key: <apiKey>" \
5	-H "Content-Type: application/json" \
6	-d '{
7	"region": {
8	"country": "country"
9	}
10	}'

1	{
2	"requestId": "01J949482NZT359YHTT07X6GBT",
3	"matchedOrganizations": [
4	{
5	"country": "string",
6	"addresses": [
7	{
8	"country": "AUS",
9	"addressId": "b39ec506-712e-47b6-a0f5-50d9e5fb34e9",
10	"buildingName": "buildingName",
11	"careOf": "careOf",
12	"district": "district",
13	"locality": "NEDLANDS",
14	"longForm": "longForm",
15	"neighborhood": "neighborhood",
16	"postalCode": "6009",
17	"sourceId": "d37e3af7-8c3b-48c7-8d50-3ec07d4375f9",
18	"status": "CURRENT",
19	"streetName": "141 BROADWAY",
20	"streetNumber": "streetNumber",
21	"streetType": "streetType",
22	"subdivision": "subdivision",
23	"type": "BUSINESS",
24	"typeDescription": "typeDescription",
25	"unitNumber": "LEVEL 1",
26	"unstructuredLongForm": "unstructuredLongForm",
27	"validFrom": {
28	"day": "07",
29	"month": "08",
30	"normalized": "1990-03-31",
31	"type": "BUDDHIST",
32	"unstructured": "2006-08-07",
33	"year": "2006"
34	},
35	"validTo": {
36	"day": "27",
37	"month": "03",
38	"normalized": "1990-03-31",
39	"type": "BUDDHIST",
40	"unstructured": "12 Rajab 1445 AH",
41	"year": "1990"
42	}
43	}
44	],
45	"alternateNames": [
46	{
47	"name": "name",
48	"type": "type",
49	"validFrom": {
50	"day": "27",
51	"month": "03",
52	"normalized": "1990-03-31",
53	"type": "BUDDHIST",
54	"unstructured": "12 Rajab 1445 AH",
55	"year": "1990"
56	},
57	"validTo": {
58	"day": "27",
59	"month": "03",
60	"normalized": "1990-03-31",
61	"type": "BUDDHIST",
62	"unstructured": "12 Rajab 1445 AH",
63	"year": "1990"
64	},
65	"sourceId": "sourceId"
66	}
67	],
68	"emailAddresses": [
69	{
70	"emailAddressId": "aa385f64-5717-4562-b3fc-2c963f66af21",
71	"type": "OTHER",
72	"sourceId": "31dd15f64-5717-4562-b3fc-2c963f66234d",
73	"email": "leonardo_dc@outlook.com",
74	"isPreferred": true,
75	"linkedAddresses": [
76	{
77	"addressId": "adc215f64-5717-4562-b3fc-2c963f66222a"
78	}
79	]
80	}
81	],
82	"name": {
83	"name": "name",
84	"type": "type",
85	"validFrom": {
86	"day": "27",
87	"month": "03",
88	"normalized": "1990-03-31",
89	"type": "BUDDHIST",
90	"unstructured": "12 Rajab 1445 AH",
91	"year": "1990"
92	},
93	"validTo": {
94	"day": "27",
95	"month": "03",
96	"normalized": "1990-03-31",
97	"type": "BUDDHIST",
98	"unstructured": "12 Rajab 1445 AH",
99	"year": "1990"
100	},
101	"sourceId": "sourceId"
102	},
103	"organizationToken": "string",
104	"phoneNumbers": [
105	{
106	"phoneNumberId": "ad165f64-5717-4562-b3fc-2c963f66bfa9",
107	"isPreferred": true,
108	"type": "OTHER",
109	"sourceId": "14fd5f64-5717-4562-b3fc-2c963f66ba34",
110	"country": "AUS",
111	"number": "0426192340",
112	"linkedAddresses": [
113	{
114	"addressId": "fa335f64-5717-4562-b3fc-2c963f66cf41"
115	}
116	],
117	"unstructuredLongForm": "unstructuredLongForm"
118	}
119	],
120	"registrationDetails": [
121	{
122	"registrationNumber": "11000016722",
123	"class": {
124	"code": "LMSH",
125	"description": "Limited By Shares",
126	"sourceId": "d37e3af7-8c3b-48c7-8d50-3ec07d4375f9"
127	},
128	"extractedDate": {
129	"day": "07",
130	"month": "08",
131	"normalized": "2006-08-07",
132	"type": "BUDDHIST",
133	"unstructured": "2006-08-07",
134	"year": "2006"
135	},
136	"foundationDate": {
137	"day": "27",
138	"month": "03",
139	"normalized": "1990-03-31",
140	"type": "BUDDHIST",
141	"unstructured": "12 Rajab 1445 AH",
142	"year": "1990"
143	},
144	"isCurrent": true,
145	"isSuppressed": true,
146	"registeredCountry": "registeredCountry",
147	"registeredDate": {
148	"day": "07",
149	"month": "08",
150	"normalized": "2006-08-07",
151	"type": "BUDDHIST",
152	"unstructured": "2006-08-07",
153	"year": "2006"
154	},
155	"registeredName": {
156	"name": "name",
157	"type": "type",
158	"validFrom": {
159	"day": "27",
160	"month": "03",
161	"normalized": "1990-03-31",
162	"type": "BUDDHIST",
163	"unstructured": "12 Rajab 1445 AH",
164	"year": "1990"
165	},
166	"validTo": {
167	"day": "27",
168	"month": "03",
169	"normalized": "1990-03-31",
170	"type": "BUDDHIST",
171	"unstructured": "12 Rajab 1445 AH",
172	"year": "1990"
173	},
174	"sourceId": "sourceId"
175	},
176	"registeredSubdivision": "registeredSubdivision",
177	"registrationNumberDescription": "Australian Business Number",
178	"registrationNumberType": "ABN",
179	"registrationStatus": {
180	"normalized": {
181	"code": "code",
182	"description": "description"
183	},
184	"unstructured": {
185	"code": "code",
186	"description": "description"
187	},
188	"sourceId": "sourceId"
189	},
190	"registry": "ABR",
191	"registryDescription": "registryDescription",
192	"reviewDate": {
193	"day": "27",
194	"month": "03",
195	"normalized": "1990-03-31",
196	"type": "BUDDHIST",
197	"unstructured": "12 Rajab 1445 AH",
198	"year": "1990"
199	},
200	"sourceId": "sourceId",
201	"status": {
202	"normalized": {
203	"code": "ACTV",
204	"description": "ACTIVE"
205	},
206	"unstructured": {
207	"code": "REGD",
208	"description": "Registered"
209	},
210	"sourceId": "d37e3af7-8c3b-48c7-8d50-3ec07d4375f9"
211	},
212	"subClass": {
213	"code": "code",
214	"description": "description",
215	"sourceId": "sourceId"
216	},
217	"subType": {
218	"code": "code",
219	"description": "description",
220	"sourceId": "sourceId"
221	},
222	"type": {
223	"code": "code",
224	"description": "description",
225	"sourceId": "sourceId"
226	},
227	"updatedDate": {
228	"day": "07",
229	"month": "08",
230	"normalized": "2006-08-07",
231	"type": "BUDDHIST",
232	"unstructured": "2006-08-07",
233	"year": "2006"
234	},
235	"validFrom": {
236	"day": "27",
237	"month": "03",
238	"normalized": "1990-03-31",
239	"type": "BUDDHIST",
240	"unstructured": "12 Rajab 1445 AH",
241	"year": "1990"
242	},
243	"validTo": {
244	"day": "27",
245	"month": "03",
246	"normalized": "1990-03-31",
247	"type": "BUDDHIST",
248	"unstructured": "12 Rajab 1445 AH",
249	"year": "1990"
250	}
251	}
252	],
253	"status": {
254	"normalized": {
255	"code": "code",
256	"description": "description"
257	},
258	"unstructured": {
259	"code": "code",
260	"description": "description"
261	},
262	"sourceId": "sourceId"
263	},
264	"subdivision": "string",
265	"type": {
266	"code": "code",
267	"description": "description"
268	},
269	"websiteUrls": [
270	{
271	"websiteUrl": "websiteUrl",
272	"sourceId": "sourceId"
273	}
274	]
275	}
276	],
277	"queryDetails": {
278	"region": {
279	"country": "AUS",
280	"subdivision": "subdivision"
281	},
282	"organizationName": "INSURANCE AUSTRALIA LIMITED",
283	"organizationNumber": {
284	"registrationNumber": "11000016722",
285	"registryCode": "ABN"
286	}
287	}
288	}