For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
LearnGraph LoginRequest a Demo
HomeAPIBulk DataSayari LibraryChange Log
  • Key Concepts
    • Introduction
    • Endpoint Overview
    • Authentication
    • Requests
    • Pagination
    • Response Status Codes
    • Data Types
    • Rate Limits
  • API Clients
    • Overview
    • Open API
    • Postman
    • Go
    • Python
    • Node
  • API Reference
      • POSTSearch Shipments
      • POSTSearch Suppliers
      • POSTSearch Buyers
  • Guides
    • Getting Started
    • Understanding Project Entity
    • Risk Factors
    • Entity Search
    • Advanced Entity Search
    • Resolution
    • Trade Search - Shipments
    • Trade Search - Suppliers & Buyers
    • v0 Migration
  • Implementation Patterns
    • Project Entity Supply Chain
  • Use Cases
    • Entity Screening & Verification
    • Investigations
LogoLogo
LearnGraph LoginRequest a Demo
API ReferenceTrade

Search Suppliers

GA
POST
/v1/trade/search/suppliers
POST
/v1/trade/search/suppliers
$curl -X POST "https://api.sayari.com/v1/trade/search/suppliers?limit=1" \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "filter": {
>    "departure_country": [
>      "DEU"
>    ],
>    "arrival_country": [
>      "RUS"
>    ],
>    "hs_code": [
>      "854231"
>    ],
>    "arrival_date": "2024-01|2024-10"
>  }
>}'
1{
2  "data": [
3    {
4      "addresses": [
5        "WALDHOERNLESTRASSE 17 72072 TUEBINGEN 0 GERMANY",
6        "72072, , TUEBINGEN, WALDHOERNLESTRASSE 17,",
7        "WALDHÖRNLESTRAßE 17"
8      ],
9      "attribute_count": {
10        "company_type": 6,
11        "name": 2,
12        "business_purpose": 11,
13        "identifier": 8,
14        "additional_information": 2,
15        "country": 22,
16        "contact": 3,
17        "status": 5,
18        "address": 20,
19        "financials": 1
20      },
21      "closed": false,
22      "countries": [
23        "USA",
24        "SWE",
25        "BEL",
26        "MEX",
27        "ITA",
28        "SGP",
29        "ECU",
30        "DEU",
31        "BRA",
32        "CAN"
33      ],
34      "degree": 6349,
35      "entity_url": "/v1/entity/yNwunHdFInERKig0Thusgg",
36      "id": "yNwunHdFInERKig0Thusgg",
37      "identifiers": [
38        {
39          "value": "52990027L4WYH1AZ2T91",
40          "type": "lei",
41          "label": "Lei"
42        },
43        {
44          "value": "26.035.445/0001-09",
45          "type": "bra_cnpj",
46          "label": "Bra Cnpj"
47        },
48        {
49          "value": "B8534_HRB380137",
50          "type": "deu_registernummer",
51          "label": "Deu Registernummer"
52        },
53        {
54          "value": "0507.995.037",
55          "type": "bel_enterprise_number",
56          "label": "Bel Enterprise Number"
57        },
58        {
59          "value": "LBB853438013700000",
60          "type": "validatis_number",
61          "label": "Validatis Number"
62        }
63      ],
64      "label": "ERBE ELEKTROMEDIZIN GMBH",
65      "metadata": {
66        "shipments": 6,
67        "hsCodes": [
68          {
69            "key": "854231",
70            "doc_count": 6,
71            "value": "Electronic integrated circuits; processors and controllers, whether or not combined with memories, converters, logic circuits, amplifiers, clock and timing circuits, or other circuits",
72            "value_simple": "Integrated Circuits"
73          }
74        ],
75        "latestShipmentDate": "2024-07-10"
76      },
77      "pep": false,
78      "psa_count": 1,
79      "related_entities_count": 6349,
80      "relationship_count": {
81        "linked_to": 2,
82        "officer_of": 1,
83        "has_officer": 5,
84        "shareholder_of": 3,
85        "has_shareholder": 1,
86        "has_director": 1,
87        "has_lawyer": 1,
88        "owner_of": 20,
89        "ships_to": 30,
90        "receives_from": 3,
91        "subsidiary_of": 1,
92        "has_subsidiary": 1,
93        "has_legal_representative": 5
94      },
95      "risk": {
96        "basel_aml": {
97          "value": 5.07,
98          "metadata": {
99            "country": [
100              "ECU"
101            ]
102          },
103          "level": "relevant"
104        },
105        "exports_bis_high_priority_items_critical_components_direct": {
106          "value": 1,
107          "metadata": {
108            "origin_shipment_product": [
109              "854231"
110            ]
111          },
112          "level": "high"
113        },
114        "cpi_score": {
115          "value": 34,
116          "metadata": {
117            "country": [
118              "ECU"
119            ]
120          },
121          "level": "relevant"
122        },
123        "exports_bis_high_priority_items_indirect": {
124          "value": 1,
125          "metadata": {
126            "origin_shipment_product": [
127              "853669"
128            ]
129          },
130          "level": "elevated"
131        }
132      },
133      "sanctioned": false,
134      "source_count": {
135        "ee100f9b5dfdae8991ba43f5de6e1854": {
136          "count": 8,
137          "label": "Panama Imports & Exports (January 2022 - Present)"
138        },
139        "26a8072830039f470287902c1530ef79": {
140          "count": 6,
141          "label": "Belgium Crossroads Bank for Enterprises"
142        },
143        "c7c2684a1a28cce25025c6b7c6a97bf1": {
144          "count": 24,
145          "label": "Colombia Imports & Exports (2008-2020)"
146        },
147        "d302aa0d7153d87aeaa4406f9a3b28fa": {
148          "count": 109,
149          "label": "Colombia Imports & Exports (January 2022 - Present)"
150        },
151        "9615bab28dddcc89548c928ab192ee7c": {
152          "count": 11,
153          "label": "Sri Lanka Imports & Exports (January 2023 - Present)"
154        },
155        "c22aabd1653affa3d007fb01dcc66b72": {
156          "count": 3,
157          "label": "Singapore Handshakes Shareholder Profiles (3rd Party Data)"
158        },
159        "33ce74530696fdc957af6e05194905a2": {
160          "count": 1,
161          "label": "Nicaragua Imports & Exports (January 2024 - Present)"
162        },
163        "16279c76cf40cfb1f5ad0809e6a76fd7": {
164          "count": 2,
165          "label": "Italy Company Registry (3rd Party Data)"
166        },
167        "4a34a8375e7041cf8661fa82366c60ea": {
168          "count": 161,
169          "label": "Ecuador Imports & Exports (January 2022 - Present)"
170        },
171        "8511f57f6098dcc36e3a814c3ea5bdd7": {
172          "count": 3,
173          "label": "Uzbekistan Imports & Exports (January 2022 - Present)"
174        },
175        "b812677c0a32a1746b3ac741c7b97ae0": {
176          "count": 58,
177          "label": "Legal Entity Identifier (LEI) Registry (3rd Party Data)"
178        },
179        "ac1fa195f9cd4ccf657bca3c6db0bb19": {
180          "count": 1,
181          "label": "USA Patents and Trademark Office Trademark Applications"
182        },
183        "7a92887d4f18fc21abe0d658b25364e7": {
184          "count": 735,
185          "label": "USA USASpending.gov Profiles Database"
186        },
187        "a7829d9c8999fcaa78af55886da9be06": {
188          "count": 42,
189          "label": "Turkey Imports & Exports (January 2024 - Present)"
190        },
191        "92fbab1cd3a92b583e0ec0ca5c48a254": {
192          "count": 1,
193          "label": "Germany Handelsregister Announcements"
194        },
195        "ce462e9deea545cce35df38c48512a0c": {
196          "count": 5243,
197          "label": "India Imports & Exports (January 2023 - Present)"
198        },
199        "66dfefb726ae00fde8f09f34c5578d35": {
200          "count": 227,
201          "label": "Russia Imports & Exports (January 2023 - Present)"
202        },
203        "83ffee6075e54030397fa4c499a5a7ba": {
204          "count": 4,
205          "label": "Tanzania Imports & Exports (January 2023 - Present)"
206        },
207        "5547652362cfeeb62963e058f95d6fdd": {
208          "count": 66,
209          "label": "Peru Imports & Exports (January 2023 - Present)"
210        },
211        "e5de7b52cc88ef4cd1a10e201bdf46ee": {
212          "count": 71,
213          "label": "Vietnam Imports & Exports (January 2023 - Present)"
214        },
215        "b9d809b02049993ba8dc2e4c5f7cceca": {
216          "count": 152,
217          "label": "Mexico Industrial Property Trademark Registry (MARCIA)"
218        },
219        "31df3cc3a57cc4a39dcc29dd4b9ce5e5": {
220          "count": 108,
221          "label": "Mexico Imports & Exports (January 2022 - Present)"
222        },
223        "31d2e44e0e61ae41a8a7d09b8499fd4e": {
224          "count": 1,
225          "label": "Belgium KBO Open Data (Active Entities)"
226        },
227        "b2695e88b6f5b89ba1d9011e06dbcbc7": {
228          "count": 4,
229          "label": "Botswana Imports & Exports (January 2023 - Present)"
230        },
231        "f5fdf9a3e7f4ae43eae3191eea1f3127": {
232          "count": 1,
233          "label": "Sweden Business Register (Statistics Sweden)"
234        },
235        "9c66f2f4dc556f40ce096ebf4f0c97ac": {
236          "count": 7,
237          "label": "Germany Validatis Shareholder Lists (3rd Party Data)"
238        },
239        "16a4cc2d0f467fa993b28587d542a25d": {
240          "count": 398,
241          "label": "USA Imports (2021 - Present)"
242        },
243        "a4475601393f5a6a27154175556f7a85": {
244          "count": 2,
245          "label": "Canada Intellectual Property Office Trademarks Database"
246        },
247        "fecea39fdc2bbbca36ed77ff68c8c89b": {
248          "count": 32,
249          "label": "Brazil Receita Federal"
250        },
251        "96c06a5a03b61b91324c7e05b3114fb6": {
252          "count": 3,
253          "label": "Ukraine Imports & Exports (January 2023 - May 2023)"
254        },
255        "0b325d9555f1011ae80446f3778bc3c8": {
256          "count": 1,
257          "label": "Paraguay Imports & Exports (January 2022 - Present)"
258        },
259        "41c82cb8bda87edc819b7790081e1e26": {
260          "count": 12,
261          "label": "Ghana Imports (January 2023 - Present)"
262        },
263        "9f22a5470e1faf82004e203d094cca29": {
264          "count": 4,
265          "label": "Kenya Imports (January 2024 - present)"
266        },
267        "a6cd51a15ff02fb3ab273f3c90d2097c": {
268          "count": 2,
269          "label": "Italy Chambers of Commerce Registry"
270        },
271        "b7593dcf982bcb9ca86f24ef369ed1e5": {
272          "count": 145,
273          "label": "Philippines Imports & Exports (January 2023 - Present)"
274        }
275      },
276      "trade_count": {
277        "sent": 6278,
278        "received": 5
279      },
280      "type": "company",
281      "user_attribute_count": {},
282      "user_record_count": 0,
283      "user_related_entities_count": 0,
284      "user_relationship_count": {},
285      "attribute_counts": {
286        "company_type": 6,
287        "name": 2,
288        "business_purpose": 11,
289        "identifier": 8,
290        "additional_information": 2,
291        "country": 22,
292        "contact": 3,
293        "status": 5,
294        "address": 20,
295        "financials": 1
296      },
297      "company_type": "Foreign entity",
298      "latest_status": {
299        "status": "active",
300        "date": "2015-01-07"
301      },
302      "psa_id": "4904853096420",
303      "reference_id": "fecea39fdc2bbbca36ed77ff68c8c89b/27709659/1566236147596:c14ee31028469ae2871467bb07abc96a",
304      "registration_date": "Registered 1965-07-20",
305      "user_attribute_counts": {}
306    }
307  ],
308  "limit": 1,
309  "next": true,
310  "offset": 0,
311  "size": {
312    "count": 4,
313    "qualifier": "eq"
314  }
315}
Search for a supplier. Please note, searches are limited to a maximum of 10,000 results.
Was this page helpful?
Previous

Search Buyers

Next
Built with

Authentication

AuthorizationBearer

OAuth authentication of the form <token>.

Query parameters

limitintegerOptional
A limit on the number of objects to be returned with a range between 1 and 3000. Defaults to 100.
offsetintegerOptional
Number of results to skip before returning response. Defaults to 0.

Request

This endpoint expects an object.
qstringOptional
Query term. The syntax for the query parameter follows elasticsearch simple query string syntax. The includes the ability to use search operators and to perform nested queries. Must be url encoded.
filterobjectOptional

Filters to be applied to search query to limit the result-set.

facetsbooleanOptional
Whether or not to return search facets in results giving counts by field. Defaults to false.

Response

This endpoint returns an object.
datalist of objects
limitinteger
nextboolean
offsetinteger
sizeobject

Errors

400
Bad Request
401
Unauthorized
405
Method Not Allowed
429
Rate Limit Exceeded
500
Internal Server Error