POST
https://api.milda.ai/v1/trade-data/candidatesCandidates
application/json01
Description
Trade Data — Candidates
POST /v1/trade-data/candidates
Step 1 of trade data. Given a company, returns the matching companies (candidates) found in the trade database, each with shipment counts.
Request
company_id(required) — Company ID.
Response
List of candidates:
- candidate_id — pass this to the other trade-data endpoints.
- name, country_code
- total_import_shipments, total_export_shipments
Returns 204 No Content if no matches are found.
Flow & credits
Pick a candidate_id from the results and call POST /v1/trade-data/analytics. This candidates step is free.
02
Headers
nameinreqdescription
tokenheaderyesAPI token. Issued per account; check it with GET /v1/credit-usage.
03
Request body
TradeCandidatesRequestTradeCandidatesRequesttypereq1 fields
company_idstringyesCompany ID.
04
Responses
200 Successful Response422 Validation Error