POST
https://api.milda.ai/v1/trade-data/shipment-recipientsShipment Recipients
application/json01
Description
Trade Data — Shipment Recipients
POST /v1/trade-data/shipment-recipients
Ranked list of shipment recipients (importers that receive shipments from the candidate company), 10 per page. Use this to see who the company sells to.
Request
candidate_id(required) — from acandidatesresult.page_no(optional, default1) — page number; 10 recipients per page.
Response
List of recipients, ranked by trade volume. Each item includes: rank, id, name, domain, country {name, code, name_cn}, total_import_value, total_shipments, total_import_quantity, total_weight, import_countries, export_countries, loading_ports, unloading_ports, products.
Returns 204 No Content when the page has no recipients.
Credits
Charged a flat fee per page (data credits).
02
Headers
nameinreqdescription
tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.
03
Request body
TradePartnersRequestTradePartnersRequesttypereq2 fields
candidate_idstringyescandidate_id from a candidates result.
page_nointeger—Page number (10 partners per page).min 1 · default 1
04
Responses
200 Successful Response422 Validation Error