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 Shipments

GA
POST
/v1/trade/search/shipments
POST
/v1/trade/search/shipments
$curl -X POST "https://api.sayari.com/v1/trade/search/shipments?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      "id": "Sdl3aYnJ23Y-3IxgIOkXPA",
5      "type": "shipment",
6      "buyer": [
7        {
8          "id": "uWNWgzX-Kvp1j-WeXKmLQw",
9          "type": "receiver_of",
10          "names": [
11            "ООО \"ЭРБЭ ЭЛЕКТРОМЕДИЦИН\"",
12            "LLC \"ERBE ELECTROMEDICAL\"",
13            "LIMITED LIABILITY COMPANY ERBE ELECTROMEDITSIN",
14            "GESELLSCHAFT MIT BESCHRANKTER HAFTUNG \"ERBE ELEKTROMEDIZIN\""
15          ],
16          "risks": {
17            "imports_bis_high_priority_items": 1,
18            "imports_bis_high_priority_items_critical_components": 1
19          },
20          "business_purpose": [
21            {
22              "code": "47.73",
23              "value": "Торговля розничная лекарственными средствами в специализированных магазинах (аптеках)"
24            },
25            {
26              "code": "47.74",
27              "value": "Торговля розничная изделиями, применяемыми в медицинских целях, ортопедическими изделиями в специализированных магазинах"
28            },
29            {
30              "code": "47.75",
31              "value": "Торговля розничная косметическими и товарами личной гигиены в специализированных магазинах"
32            },
33            {
34              "code": "46.46",
35              "value": "Торговля оптовая фармацевтической продукцией"
36            },
37            {
38              "code": "4646",
39              "standard": "ISIC4"
40            },
41            {
42              "code": "4775",
43              "standard": "ISIC4"
44            },
45            {
46              "code": "4774",
47              "standard": "ISIC4",
48              "value": "Retail sale of second-hand goods"
49            },
50            {
51              "code": "4773",
52              "standard": "ISIC4",
53              "value": "Other retail sale of new goods in specialized stores"
54            },
55            {
56              "code": "3313",
57              "standard": "ISIC4",
58              "value": "Repair of electronic and optical equipment"
59            },
60            {
61              "code": "33.13",
62              "value": "Ремонт электронного и оптического оборудования"
63            }
64          ],
65          "address": [
66            {
67              "x": 37.57419598175875,
68              "city": "Г.москва",
69              "y": 55.71777599664301,
70              "country": "RUS",
71              "value": "119270, , MOSCOW, KHAMOVNICHESKY VAL STREET, 12, FLOOR 2, ROOM. X, ROOM 15,"
72            },
73            {
74              "x": 37.57419598175875,
75              "city": "Г.москва",
76              "y": 55.71777599664301,
77              "country": "RUS",
78              "value": "119270, , Г.МОСКВА, УЛ.ХАМОВНИЧЕСКИЙ ВАЛ,Д.12,ЭТ.2,ПОМ.Х,КОМ.15,"
79            },
80            {
81              "x": 37.57419598175875,
82              "city": "Г.москва",
83              "y": 55.71777599664301,
84              "country": "RUS",
85              "value": "119270, , MOSCOW, KHAMOVNICHESKY VAL STREET, 12, FL12, ROOM.H, ROOM 15,"
86            },
87            {
88              "x": 37.57419598175875,
89              "city": "Г.москва",
90              "y": 55.71777599664301,
91              "country": "RUS",
92              "value": "119270, , Г.МОСКВА, УЛ.ХАМОВНИЧЕСКИЙ ВАЛ,Д.12,ЭТ12,ПОМ.Х,КОМ.15,"
93            },
94            {
95              "x": 37.57419598175875,
96              "city": "Город Москва",
97              "y": 55.71777599664301,
98              "country": "RUS",
99              "value": "119270, ГОРОД МОСКВА, УЛ. ХАМОВНИЧЕСКИЙ ВАЛ, Д. 12, ЭТАЖ 2 ПОМ Х КОМ 15"
100            },
101            {
102              "x": 37.57419598175875,
103              "city": "Город Москва",
104              "y": 55.71777599664301,
105              "country": "RUS",
106              "value": "119270, MOSCOW, KHAMOVNICHESKY VAL STREET, BUILDING 12, FLOOR 2 ROM X ROOM 15"
107            },
108            {
109              "x": 37.57419598175875,
110              "city": "Город Москва",
111              "y": 55.71777599664301,
112              "country": "RUS",
113              "value": "119270, CITY MOSCOW, ST. KHAMOVNICHESKY VAL, 12, FLOOR 2 ROM X ROOM 15"
114            },
115            {
116              "x": 37.57419598175875,
117              "city": "Город Москва",
118              "y": 55.71777599664301,
119              "country": "RUS",
120              "value": "119270, ГОРОД МОСКВА, УЛИЦА ХАМОВНИЧЕСКИЙ ВАЛ, ДОМ 12, ЭТАЖ 2 ПОМ Х КОМ 15"
121            }
122          ],
123          "countries": [
124            "RUS"
125          ]
126        }
127      ],
128      "supplier": [
129        {
130          "id": "yNwunHdFInERKig0Thusgg",
131          "type": "shipper_of",
132          "names": [
133            "ERBE ELEKTROMEDIZIN GMBH",
134            "ERBE ELEKTROMED"
135          ],
136          "risks": {
137            "exports_bis_high_priority_items_critical_components_direct": 1,
138            "exports_bis_high_priority_items_indirect": 1
139          },
140          "business_purpose": [
141            {
142              "code": "6420",
143              "standard": "ISIC4",
144              "value": "Activities of holding companies"
145            },
146            {
147              "code": "7010",
148              "standard": "ISIC4",
149              "value": "Activities of head offices"
150            },
151            {
152              "code": "64.62-0",
153              "standard": "CNAE2",
154              "value": "Holdings de instituições não-financeiras"
155            },
156            {
157              "code": "2660",
158              "standard": "ISIC4",
159              "value": "Manufacture of irradiation, electromedical and electrotherapeutic equipment"
160            },
161            {
162              "code": "26.60",
163              "standard": "NACE2",
164              "value": "Manufacture of irradiation, electromedical and electrotherapeutic equipment"
165            },
166            {
167              "code": "3250",
168              "standard": "ISIC4",
169              "value": "Manufacture of medical and dental instruments and supplies"
170            },
171            {
172              "code": "32.50",
173              "standard": "NACE2",
174              "value": "Manufacture of medical and dental instruments and supplies"
175            },
176            {
177              "code": "3313",
178              "standard": "ISIC4",
179              "value": "Repair of electronic and optical equipment"
180            },
181            {
182              "code": "33.13",
183              "standard": "NACE2",
184              "value": "Repair of electronic and optical equipment"
185            },
186            {
187              "code": "4649",
188              "standard": "ISIC4",
189              "value": "Wholesale of other household goods"
190            },
191            {
192              "code": "46.46",
193              "standard": "NACE2",
194              "value": "Wholesale of pharmaceutical goods"
195            }
196          ],
197          "address": [
198            {
199              "x": 9.057763185844635,
200              "city": "Tübingen",
201              "state": "bw",
202              "y": 48.49839220684879,
203              "country": "DEU",
204              "value": "WALDHOERNLESTRASSE 17 72072 TUEBINGEN 0 GERMANY"
205            },
206            {
207              "x": 9.057763185844635,
208              "city": "Tuebingen",
209              "y": 48.49839220684879,
210              "country": "DEU",
211              "value": "72072, , TUEBINGEN, WALDHOERNLESTRASSE 17,"
212            },
213            {
214              "value": "WALDHÖRNLESTRAßE 17"
215            },
216            {
217              "x": 9.056857700153852,
218              "city": "Tuebingen",
219              "y": 48.49829144306095,
220              "country": "DEU",
221              "value": "WALDHOERNLESTRASSE TUEBINGEN 72072"
222            },
223            {
224              "x": 9.052098,
225              "city": "Tubingen",
226              "y": 48.522904,
227              "country": "Alemania",
228              "value": "TUBINGEN, ALEMANIA"
229            },
230            {
231              "value": "ООО \"ЭРБЭ ЭЛЕКТРОМЕДИЦИН\""
232            },
233            {
234              "x": 9.060085569236273,
235              "city": "Tubingen",
236              "y": 48.493932657539084,
237              "country": "DEU",
238              "value": "WALDHORNSTRASSE. 17 72072 TBINGEN D ,TUBINGEN ,[email protected]"
239            },
240            {
241              "x": 9.052220000000034,
242              "city": "Tubinga",
243              "y": 48.52266000000003,
244              "country": "Alemania",
245              "value": "TUBINGA, ALEMANIA"
246            },
247            {
248              "value": "WALDHOERNLESTRASSE 17 72072 TUEBING ,TUBINGA ,[email protected]"
249            },
250            {
251              "x": -64.65251108919011,
252              "y": -4.155371602541514,
253              "country": "BRA",
254              "value": "JAPON E5-107 Y AV. AMAZONAS"
255            },
256            {
257              "x": 9.052098,
258              "city": "TUBINGEN",
259              "y": 48.522904,
260              "country": "DEU",
261              "value": "1420-DE-72004 TUBINGEN"
262            },
263            {
264              "x": -78.48600274748468,
265              "city": "Quito",
266              "y": -0.17858591191971498,
267              "country": "Ecuador",
268              "value": "JAPON ES 107 AV. AMAZONAS 170506 QUITO ECUADOR"
269            },
270            {
271              "x": 9.057763185844635,
272              "y": 48.49839220684879,
273              "country": "DEU",
274              "value": "WALDHÖRNLESTRASSE  NUM. EXT. 17"
275            },
276            {
277              "x": 8.9971125,
278              "city": "TUBINGEN",
279              "y": 48.4834617,
280              "country": "Deutschland",
281              "value": "72072 TBINGEN, DEUTSCHLAND"
282            },
283            {
284              "x": 80.0602634,
285              "city": "OKÄND",
286              "y": 6.2482506,
287              "country": "LKA",
288              "value": "OKÄND"
289            },
290            {
291              "x": 80.0602634,
292              "city": "OKÄND",
293              "y": 6.2482506,
294              "country": "LKA",
295              "value": "OKÄND"
296            },
297            {
298              "x": -78.48600822430384,
299              "city": "Quito",
300              "y": -0.1786202845064082,
301              "country": "Ecuador",
302              "value": "JAPON E5-107 Y AV. AMAZONAS QUITO ECUADOR"
303            },
304            {
305              "x": -78.48600822430384,
306              "city": "Quito",
307              "y": -0.1786202845064082,
308              "country": "Ecuador",
309              "value": "JAPON E5 107 Y AV. AMAZONAS QUITO ECUADOR"
310            },
311            {
312              "x": -64.65251108919011,
313              "city": "Es-107av.",
314              "state": "Amazonas",
315              "y": -4.155371602541514,
316              "country": "BRA",
317              "value": "(EMPRESA GRUPOCOR) JAPON ES-107AV. AMAZONAS"
318            },
319            {
320              "x": -66.08332999999993,
321              "y": -3.533329999999978,
322              "country": "BRA",
323              "value": "JAPON ES 107 AV. AMAZONAS"
324            },
325            {
326              "x": -64.65251108919011,
327              "y": -4.155371602541514,
328              "country": "BRA",
329              "value": "JAPON E5 107 Y AV AMAZONAS"
330            }
331          ],
332          "countries": [
333            "DEU",
334            "USA",
335            "MEX",
336            "BRA",
337            "BEL",
338            "ECU",
339            "ITA",
340            "SGP",
341            "CAN",
342            "SWE",
343            "ZAF"
344          ]
345        }
346      ],
347      "arrival_country": [],
348      "departure_country": [
349        "USA"
350      ],
351      "transit_country": [],
352      "countries": [
353        "DEU",
354        "RUS"
355      ],
356      "product_origin": [
357        "DEU"
358      ],
359      "monetary_value": [
360        {
361          "value": 2570.52,
362          "currency": "USD",
363          "context": "cost_insurance_and_freight"
364        }
365      ],
366      "weight": [
367        {
368          "value": 5.5,
369          "unit": "kilogram",
370          "type": "net_weight"
371        }
372      ],
373      "identifier": [
374        {
375          "value": "10013160/140524/3162513",
376          "type": "rus_declaration_number"
377        },
378        {
379          "value": "1001325059",
380          "type": "ru_trade_internal_shipment_id"
381        }
382      ],
383      "sources": [
384        {
385          "id": "66dfefb726ae00fde8f09f34c5578d35",
386          "label": "Russia Imports & Exports (January 2023 - Present)"
387        }
388      ],
389      "hs_codes": [
390        {
391          "code": "854231",
392          "description": "Electronic integrated circuits; processors and controllers, whether or not combined with memories, converters, logic circuits, amplifiers, clock and timing circuits, or other circuits",
393          "imputed": false
394        }
395      ],
396      "product_descriptions": [
397        "СХЕМЫ ИНТЕГРАЛЬНЫЕ МОНОЛИТНЫЕ, ЦИФРОВЫЕ, НЕ ЛОМ ЭЛЕКТРООБОРУДОВАНИЯ, НЕ СОДЕРЖАТ КРИПТОГРАФИЧЕСКИХ МОДУЛЕЙ И ПРИЕМОПЕРЕДАТОЧНЫХ УСТР-В, НЕ ДЛЯ ШИФРОВАНИЯ, ГРАЖДАНСКОГО НАЗНАЧЕНИЯ, ДЛЯ ИСПОЛЬЗОВАНИЯ В СОСТАВЕ МЕДИЦИНСКОГО ОБОРУДОВАНИЯ:"
398      ],
399      "record": "4337bf42a200a30b90d536c5992167e1/1001325059/1721001600000/0",
400      "arrival_date": [
401        "2024-01-30"
402      ],
403      "departure_date": [
404        "2022-05"
405      ],
406      "departure_address": {
407        "country": "DEU"
408      },
409      "arrival_address": {
410        "country": "RUS - BRB"
411      },
412      "shipper_address": {
413        "city": "Toronto",
414        "state": "ON",
415        "country": "CAN"
416      },
417      "receiver_address": {
418        "city": "Moscow",
419        "state": "Moscow",
420        "country": "RUS"
421      }
422    }
423  ],
424  "limit": 1,
425  "next": true,
426  "offset": 0,
427  "size": {
428    "count": 13,
429    "qualifier": "eq"
430  }
431}
Search for a shipment. Please note, searches are limited to a maximum of 10,000 results.
Was this page helpful?
Previous

Search Suppliers

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